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Preface 


This publication is primarily for readers who are responsible for the installation of 
the OS PL/I Optimizing Compiler, OS PL/I Resident Library, and OS PL/I 
Transient Library. The book describes how to install these three products under 
the IBM MVS and MVS/XA Operating Systems. To install this product under the 
IBM Virtual Machine/System Product (VM/SP) Conversational Monitor System 
(CMS), see OS PL/I Optimizing Compiler: Installation Guide for CMS, 
SC26-4122. 


You should already be familiar with the MVS or MVS/XA system used at your 
site, with the publications that describe that system, and with its job control 
language. You should also be familiar with and know how to use Release 4 and 
any subsequent releases of the System Modification Program (SMP) or the System 
Modification Program Extended (SMP/E). 


How this Book Is Organized 


The OS PL/I transient library, resident library, and optimizing compiler function 
under the control of the IBM MVS and MVS/XA Operating Systems to compile 
and execute programs written in PL/I. This book describes how to install the 
transient and resident libraries and the compiler under these systems using Release 
4.0 and all subsequent releases of the System Modification Program (SMP) or the 
System Modification Program Extended (SMP/E). This publication is divided into 
the following parts: 


« Chapter 1 gives details of system requirements, program product distribution, 
and a summary of the installation procedure for all three program products. 


« Chapter 2 through Chapter 5 give information on the installation procedures. 


— Chapter 2 covers the installation of the transient and resident libraries and 
the compiler, using the composite distribution tape. 


— Chapter 3 covers installation of the transient library. 
— Chapter 4 covers installation of the resident library. 
— Chapter 5 covers installation of the optimizing compiler. 
e« Chapter 6 describes how to run the installation verification program (IVP). 


e« Chapter 7 describes the extra steps necessary to complete the installation of 
OS PL/I’s support for CICS. 
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¢« Chapter 8 describes how to change the IBM-supplied execution-time and 
compiler option defaults according to your site’s needs. 


¢ Chapter 9 describes how to tune the compiler and libraries to your site’s 
particular needs. 


Related Publications 


For more complete and current information about the actual installation process for 
the OS PL/I Optimizing Compiler and Libraries, you must use the Program 
Directory shipped with the product distribution tape(s). In addition, you might 
want to consult the publications listed below. 

A number of publications are referred to in this manual by generic names, such as 
‘“‘Assembler Language publications.” In such cases, the actual manual you require 
will depend on your operating system. 


The following manuals might be useful during the installation of the optimizing 
compiler and the libraries under an IBM MVS or MVS/XA operating system. 


OS PL/I books: 
OS PL/I Optimizing Compiler: Programmer’s Guide, SC33-0006 
OS PL/I Optimizing Compiler: Messages, SC33-0027 
OS PL/I Optimizing Compiler: TSO User’s Guide, SC33-0029 
OS and DOS PL/I Language Reference Manual, GC26-3977 
SMP books: 


Operating System/Virtual Storage (OS/VS) System Modification Program 
(SMP) System Programmer’s Guide, GC28-0673 


OS/VS SMP Messages and Codes, GC38-1047 

System Modification Program/ Extended (SMP/E) Reference, SC28-1107 
SMP/E User’s Guide, SC28-1302 

SMP/E Terminal User’s Guide, SC28-1109 


SMP/E Messages and Codes, GC28-1108 
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CICS books: 
Customer Information Control System/Operating System/Virtual Storage 
(CICS/OS/VS) Version I Release 6 Modification 1: Installation and 
Operations Guide, SC33-0172 


CICS/OS/VS Version 1 Release 6: Application Programmer’s Reference 
Manual (Command Level), SC33-0077 


CICS/OS/VS Version I Release 6: Application Programmer’s Reference 
Manual (Macro Level), SC33-0079 


MVS and MVS/XA books: 


Operating System/Virtual System 2 (OS/VS2) System Programming Library: 
System Generation Reference, GC26-3792 


OS/VS2 System Generation Reference Supplement for MVS/SP, GD26-6027 


OS/VS2 System Programming Library: Initialization and Tuning Guide, 
GC28-0681 


Multiple Virtual Systems/370 (MVS/370) Utilities, GC26-4065 


Multiple Virtual Systems / Extended Architecture (MVS/XA) System Generation 
Reference, GC26-4009 


MVS/XA Utilities, GC26-4018 


MVS/XA System Programming Library: Initialization and Tuning Guide, 
GC28-1149 


MVS/XA System Programming Library: JES2 Initialization and Tuning Guide, 
SC23-0065 


MVS/XA System Programming Library: JES3 Initialization and Tuning Guide, 
SC23-0059 


MVS/XA Conversion Notebook, GC28-1143 


MVS/XA System Programming Library: 3 1-Bit Addressing, GC28-1158 
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Summary of Amendments 


September 1985 


CICS Support 


CMS Support 


Book Reorganization 


OS PL/I Optimizing Compiler, Release 5.1, provides support for the IBM 
Customer Information Control System/Operating System/ Virtual Storage 
(CICS/OS/VS), Version 1 Release 6.1, under the IBM MVS/Extended 
Architecture (MVS/XA) system and MVS/System Product (MVS/SP) Version 1 
Release 3. 


Specifically, OS PL/I Release 5.1 provides support for PL/I programs using the 
CICS Command Level Interface in both 24-bit and 31-bit addressing modes and 
the CICS Macro Level Interface in 24-bit addressing mode, only. 


OS PL/I Optimizing Compiler, Release 5.1, supports the Conversational Monitor 
System (CMS) of the Virtual Machine/System Product (VM/SP) Release 3 and 
any subsequent releases. The installation process for OS PL/I under CMS is 
described in OS PL/I Optimizing Compiler: Installation Guide for CMS. 


This manual has been reorganized to improve its usability. 


e The chapter describing how to install the composite product tape has been 
placed before the chapters on installing the individual product component 
tapes. 


e Information on running the sample program to verify your installation has been 
moved to Chapter 6, “Running the Installation Verification Program” on 
page 47. 


e Information on CICS support has been placed in Chapter 7, “Completing 
Installation of PL/I Support for CICS” on page 51. 


Summary of Amendments VIi 


« Discussions of how to change IBM-supplied option defaults have been moved 
to a separate chapter, Chapter 8, “Changing Option Defaults and 
Customizing PL/I” on page 55. 

The discussion of how to modify the PL/I error exit routine IBMBEER has 
also been moved to Chapter 8. 


Vili OS PL/I Installation Guide for MVS 


Contents 


Chapter 1. General Information 1 
Interrelease Compatibility 1 
System Requirements 2 

Machine Requirements 2 

Auxiliary Storage Requirements 2 

Operating System Requirements 2 
Program Product Distribution 3 

Format of Distributed Tape(s) 4 
New Programming Features 4 

New Installation-Time Option 4 

New Execution-Time Options 4 
Installation Process 5 

Installation Steps 6 

Multiple Program Product Installation 7 
Preparing for Installation 8 

Choosing Optional Subcomponents 8 

Choosing Target Libraries 8 

Cataloged Procedures 9 
Changing Option Defaults and Customizing PL/I 11 
Post Installation Tuning 11 


Chapter 2. Installing the Composite Product 13 
Distribution Tape Contents 13 
Step 1: Obtaining the JCL You Need from the Distribution Tape 14 
Making Your Copy of the Installation Jobs 14 
Step 2: Selecting Target Libraries 16 
Step 3: Establishing Your Site’s Libraries 17 
Allocating Product DataSets 17 
Allocating SMP Data Sets 18 
Adding the Cataloged Procedure to Install 19 
Step 4: Installing the Distribution Tape 19 
RECEIVEing the Composite Product 20 
APPLYing the Composite Product 20 
Verifying Correct Installation 21 
ACCEPTing the OS PL/I Product 21 
Completing Installation of CICS Support 21 
Customizing and Tuning Your OS PL/I Product 21 


Chapter 3. Installing the Transient Library 23 
Distribution Tape Contents 23 

Step 1: Obtaining the JCL You Need from the Distribution Tape 24 
Making Your Copy of the Installation Jobs 24 

Step 2: Selecting Target Libraries 26 


Contents 1X 


Step 3: Establishing Your Site’s Libraries 26 
Allocating Transient Library DataSets 26 
Allocating SMP DataSets 27 
Adding the Cataloged Procedure to Install 28 

Step 4: Installing the Distribution Tape 28 
RECEIVEing the Transient Library 29 
APPLYing the Transient Library 29 
ACCEPTing the Transient Library 30 

Completing Installation of CICS Support 30 

Customizing and Tuning Your OS PL/I Product 30 


Chapter 4. Installing the Resident Library 31 
Distribution Tape Contents 31 

Step 1: Obtaining the JCL You Need from the Distribution Tape 32 
Making Your Copy of the Installation Jobs 32 

Step 2: Selecting Target Libraries 33 

Step 3: Establishing Your Site’s Libraries 34 
Allocating Resident Library Data Sets 34 
Adding the Cataloged Procedure to Install 35 

Step 4: Installing the Distribution Tape 36 
RECEIVEing the Resident Library 36 
APPLYing the Transient and Resident Libraries 37 
ACCEPTing the Transient and Resident Library 37 

Completing Installation of CICS Support 38 

Customizing and Tuning Your OS PL/I Product 38 


Chapter 5. Installing the Optimizing Compiler 39 
Distribution Tape Contents 39 
Step 1: Obtaining the JCL You Need from the Distribution Tape 40 
Making Your Copy of the InstallationJCL 40 
Step 2: Selecting Target Libraries 42 
Step 3: Establishing Your Site’s Libraries 42 
Allocating Compiler Data Sets 42 
Adding the Cataloged Procedure to Install 43 
Step 4: Installing the Distribution Tape 44 
RECEIVEing the Optimizing Compiler 44 
APPLYing the Transient and Resident Libraries and the Compiler 45 
Verifying Correct Installation 45 
ACCEPTing the Compiler 45 
Completing Installation of CICS Support 46 
Customizing and Tuning Your OS PL/I Product 46 


Chapter 6. Running the Installation Verification Program 47 
Printing the Sample Program 47 
Compiling, Link-Editing, and Executing the Sample Program 47 
Interpreting Messages Generated by the Sample Program 48 
ACCEPTing Your PL/I Product 49 


Chapter 7. Completing Installation of PL/I Support for CICS 51 
Adding PPT Entries 51 

Adding DCT Entries 52 

Adding PL/I CICS Data Sets to the CICS startup job stream 52 


Chapter 8. Changing Option Defaults and Customizing PL/I 55 


X OS PL/I Installation Guide for MVS 


Changing Execution-Time Option Defaults 56 
Specifying Execution-Time Option Defaults 57 
Description of PLTRLIB Operands 57 
Coding Your Changes to the PLTRLIB Macro 65 

Changing Compiler Option Defaults 67 
Specifying Compiler Option Defaults 69 
Description of PLIXOPB and PLIXOPC Operands 70 
Coding Your Changes to the PLIXOPB and PLIXOPC Macros 75 
Rerunning the Sample Program 78 

Modifying the PL/I-Supplied Error Exit Routine 78 
Altering the IBM-Supplied IBMBEER Module 78 

Tuning Your OS PL/I Product 80 


Chapter 9. Postinstallation Tuning 81 
Using the Shared Library 81 
Deciding Whether to Create the Shared Library 82 
Establishing Compatibility Between Releases When Using Shared Library 82 
Creating the Shared Library 83 
Assembling the PLRSHR Macro 95 
Loading the Shared Library into Common Storage 96 
Loading the Shared Library for Use under CICS 97 
Using IBM Cataloged Procedures 97 
Placing Transient Library Modules in the Link Pack Area 101 
Disabling the PL/I Fast Initialization/Termination Facility 103 


Index 105 


Contents XI 


Figures 


1. Job to Copy Installation Jobs from Composite Product Distribution 
Tape 15 
2. Job to Print All Jobs in the PLI.INSTALL DataSet 16 
3. Job to Obtain the PSALLOC Member of InstallationJCL 18 
4. Job to Copy Installation Jobs from the Transient Library Tape 25 
5. Job to Print All the Jobs in the PLIINSTALL DataSet 25 
6. Job to Obtain LSALLOC Installation Job 27 
7. Job to Copy Installation Jobs from the Resident Library Tape 33 
8. Job to Print All the Jobs in the PLIL.IINSTALL DataSet 33 
9. Job to Obtain L4ALLOC Installation Job 35 
10. Job to Copy Installation Jobs from Optimizing Compiler Tape 41 
11. Job to Print All the Jobs in the PLIINSTALL DataSet 41 
12. Jobto Obtain P1ALLOC Installation Job 43 
13. Jobto Print the Sample Program 47 
14. Example of Job to Run the Sample Program 47 
15. Job to Run Sample Program from Private Libraries 48 
16. IBM-Supplied Transient Library Execution-Time Option Default 
Values 56 
17. Example of PLTRLIB Macro in IBMBXOPT Source Module 58 
18. Sample Update Statements fora USERMOD for Changing Execution-Time 
Option Defaults 65 
19. Compiler Options and Their IBM-Supplied Defaults 68 
20. Example of PLIXOPB Macro in IELOAS Source Module 71 
21. Sample USERMOD for Changing Batch Mode Compiler Option 
Defaults 75 
22. Example of a User-Written IBMBEER Replacement Module 79 
23. JCL to Include User-Written IBMBEER in PLI.LPLIBASE 80 
24. Example Job to Specify the Shared Library 84 
25. Table of Entry Points and ESD Entries in Shared Library Modules 98 
26. Transient Library Modules for the Link Pack Area 102 


Figures Xl 


Chapter 1. General Information 


This chapter contains the following information: 


e A list of the minimum system requirements for installing and using the transient 
library, resident library, and compiler, under the control of an IBM MVS or 
MVS/Extended Architecture (MVS/XA) Operating System. 


e A brief description of the new programming features introduced with Release 
5.0 of the OS PL/I Optimizing Compiler. 


e A summary of the installation process. 


This chapter begins by defining the minimum system requirements for using the 
transient library, resident library, and optimizing compiler under the control of the 
IBM MVS or MVS/XA Operating System. It describes the programming features 
introduced with Release 5.0 of the OS PL/I Optimizing Compiler and the 
installation-time and execution-time options you can use to implement them. 


It lists the major features of the installation process and summarizes the installation 
steps and the preparatory jobs you need to install the three products. 


The compiler and its libraries are distributed by IBM as an SMP installation job on 
magnetic tape(s). The process of installing the product involves executing SMP to 
place it in the appropriate program libraries. 


Before you can add the compiler and its libraries to an MVS or MVS/XA system, 
that system must be generated to meet the minimum system requirements. For 


information on MVS or MVS/XA system generation, see the System Generation 
Reference for your operating system. 


Interrelease Compatibility 


Different release levels of the optimizing compiler and libraries will produce 
compatible executions, provided that: 


e The release and service levels of the transient library are equal to or greater 
than those of the resident library. 


e The release and service levels of the resident library are equal to or greater 
than those of the compiler. 
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CICS—PL/I 
OS PL/I Release 5.1 provides support for PL/I command level application 
programs running under CICS/OS/VS 1.6.1 to use the 31-bit addressing 
capabilities of the MVS/XA operating system. It enables PL/I programs to run 
under CICS/OS/VS Version 1 Release 6 Modification 1 using the CICS 
Command Level Interface in 31-bit mode under MVS/XA and the CICS 
Command or Macro Level Interface in 24-bit mode under MVS/XA or 
MVS/SP 1.3. 
If you have PL/I program load modules that run using the PL/I interface module 
(DFHPL10I) from OS PL/I release 3.1 or 4, and the CICS command level 
interface module (DFHEPI) from CICS release 1.5, or 1.6, they will continue to 


run under CICS/OS/VS release 1.6.1, using the OS PL/I release 5.1 transient 
library CICS support modules contained in module DFHSAP. 


System Requirements 


This section summarizes the machine and operating system requirements for the 
transient library, resident library, and compiler. 


Machine Requirements 
The minimum machine requirements for installation of the optimizing compiler are: 
¢ An IBM System/370, 303x, 308x, or 43xx processor, and 


e A magnetic tape drive on which you can run the distribution tape(s) 


Auxiliary Storage Requirements 
Storage estimates for SMP are given in OS/VS System Modification Program 
(SMP) System Programmer’s Guide. Storage estimates for SMP/E are given in 
System Modification Program Extended (SMP/E) Reference. 


The storage estimates for the OS PL/I Optimizing Compiler and libraries are 
provided in the Program Directory. 


Operating System Requirements 


Subject to requirements given below, the compiler and its libraries will operate 
under the following systems: 


e OS/VS2 (MVS) Version 3 Release 8 with MVS/SP Version 1 Release 3, 
e MVS/SP Version 2 Release 1, with MVS/XA DFP Version 1 Release 1, 


and any subsequent versions, releases, and modifications. 
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OS PL/I also operates under the IBM Virtual Machine/System Product (VM/SP) 
Release 3 operating system. If you are installing under VM/SP, use OS PL/I 
Optimizing Compiler: Installation Guide for CMS instead of this book. 


Your operating system must include the following: 


e Aneligible automatic restart user abend code of 4092 if the PL/I 
Checkpoint/Restart interface is to be used, and automatic restarts are to be 
forced by PL/I programs during execution using the PLIREST statement. 


¢ JIEAXPSIM module must be in the link list if you are running under MVS/SP 
Version 1 Release 3 and your machine does not support extended floating 
point. 


e An XF-level assembler is needed to process the macro instructions used to 
change the PL/I compiler and/or execution-time option defaults. 


e Assembler H, Version 2 or later, is needed for the transient library running 
under MVS/XA, to change the PL/I execution-time option defaults. 


e CICS/OS/VS Version 1 Release 6 Modification 1 with UP90207 for 
HCI1612 (MVS/370) or UP90208 for HCI1613 (MVS/XA) or later, if you 
plan to use OS PL/I Release 5.1’s support for CICS. 


« IMS/VS Version 1 Release 2 or later if you plan to use the improved 
IMS-PL/I error handling support. 


« IMS/VS Version 1 Release 3 or later if you need support for 31-bit PL/I 
transactions under IMS/VS. 


Program Product Distribution 


The machine-readable program materials you need to install the library and 
compiler program products are distributed in the following ways: 


1. The transient library, resident library, and compiler installation material (in 
that order) are distributed on a single tape as a composite package (orderable 
as program product number 5734-PL3). 


2. The transient library, resident library, and compiler installation material are 
also distributed on three separate tapes, orderable as program products: 


e Transient Library: 5734-LMS5 
¢ Resident Library: 5734-LM4 
e Optimizing Compiler: 5734-PL1 


You may not install the resident library without the transient library; you may 
not install the compiler without both transient and resident libraries. 
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Format of Distributed Tape(s) 
The distributed tape(s) will be one of the following: 


9-track, 1600 b.p.i. 
9-track, 6250 b.p.1. 


If you order the composite package, you will receive a multifile installation tape in 
SMP format with one set of the following files for each product—transient library, 
resident library, and compiler: 


¢ SMP control statements. 
e ++JCLIN file. This is a job stream. 


e IEBCOPY unloaded data sets comprising product load modules, cataloged 
procedures, installation jobs, and macros. 


If you order the program products on separate tapes, each product comes in the 
form of a multifile installation tape in SMP format. The SMP tape has the set of 
files listed above. 


New Programming Features 


Beginning with Release 5.0, the OS PL/I optimizing compiler and libraries provide 
support for utilization of storage above 16 megabytes under MVS/SP Version 2 
Release 1, with MVS/XA DFP Version 1 Release 1. 


New Installation-Time Option 


A new option, ‘ARCH’, specified at the time of installation, indicates whether the 
system onto which you are installing the products supports both 31-bit and 24-bit 
addressing or just 24-bit addressing. 


New Execution-Time Options 


Three new execution-time options have been added to utilize extended architecture 
support: 


HEAP 


enables you to direct PL/I to isolate storage allocated to CONTROLLED 
and dynamically allocated BASED variables from all other PL/I storage, and 
to specify size and location of the HEAP area. 


ISAINC 
enables you to specify a minimum size for increments of the ISA over the 
initial allocation. Use of this option can help decrease the number of 
GETMAINSs performed during execution of a task. 
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TASKHEAP 


used only in a multitasking environment, enables you to direct PL/I to create 
separate HEAP areas for all subtasks, with their own size and location 
parameters. 


Information on specifying these options and establishing default values for them is 
in Chapter 8, “Changing Option Defaults and Customizing PL/I” on page 55. 


Installation Process 


The process of installing the OS PL/I optimizing compiler and libraries includes 
some features that are designed to simplify the process and enable you to more 
easily tune the products according to the needs of your site. 


You can select or eliminate, by specifying the appropriate function 
modification identifier (F MID), certain optional facilities included on the 
distribution tape(s). These optional features include TSO support for the 
compiler, multitasking support during program execution, and, if you are 
installing release 5.1, CICS support for PL/I command level application 
programs. 


You can obtain JCL for the various installation steps directly from the 
distribution tape(s). You can install these jobs into a temporary data set 
(which we have named PLI.IINSTALL) and erase this data set when your 
installation is complete. When you run the SMP ACCEPT job, the installation 
JCL is stored with the rest of the distributed product materials in your 
distribution libraries. 


You can copy and make minor changes to these jobs and use them when you 
run your SMP installation job. Each individual product tape includes a set of 
installation jobs designed and named for that product. The composite tape 
includes all three sets of installation jobs plus a set of jobs designed to let you 
install all three products at one time. 


You can use either SMP or SMP/E to install the products. Installation JCL is 
provided for both SMP products. 


IBM-supplied execution-time and compiler option default values are 
automatically established during SMP RECEIVE and APPLY processing. If 
these default values are satisfactory for your site, you will not need to take any 
further action. If you want to change some of the defaults, you will be able to 
do so after installation is complete by using an SMP USERMOD process. 


If you are using the composite product tape (all three components on one 


tape), the installation jobs are coded to RECEIVE the three components and 
then to APPLY them together. 
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Installation Steps 


If you are using individual product tapes, you must run your installation jobs up 
to and including the SMP RECEIVE job for each of the tapes, in the following 
sequence: 


1. The transient library first 
2. The resident library next, if your site needs it, and 
3. The compiler last, if your site needs it. 


After you have RECEIVEd all the tape(s) you have chosen for your site, you 
must APPLY all the components at the same time. 


You can install the transient library, resident library, and compiler at any time after 
your operating system is initially generated. 


First you decide which product(s) your site needs. You can install: 


¢ The transient library, or 
e The transient library and the resident library, or 
¢ The transient library, the resident library, and the compiler. 


Next, you choose the optional components your site needs. You can choose and 
install: 


¢ Miultitasking support for the transient and resident libraries 

« CICS support for the transient and resident libraries, if you are installing 
release 5.1. 

¢ TSO support for the compiler 


Next you can obtain from the distribution tape(s) the installation JCL, which you 
can modify according to your site’s needs. There are installation jobs for both SMP 
and SMP/E. 


Finally, you can execute the modified installation jobs to allocate product and SMP 
data sets, establish a cataloged procedure to be used during the installation process, 
install the product(s) using SMP, and change the execution-time and/or compiler 
option defaults, if necessary. 
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Installing Individual Product Tapes 


If you are using individual product tapes to install one or more of the products, you 
will use installation jobs designed and named for the individual product. Each 
tape’s installation jobs have names that begin with a prefix representing the product 
on that tape: 


Job Name 
Product Name Prefix 


Transient Library 
Resident Library 
[Compiler TPL 


Note: You should keep the distribution materials you received from IBM as 
backup in case you use system libraries for PL/I modules and re-creation of your 
operating system destroys and reallocates the system libraries. Also, if you do not 
install all the PL/I products at this time (if, for example, you install only the 
transient library), and later decide to install an additional PL/I product at the same 
release level (the resident library, for example), you will have to reinstall the 
previously installed product(s) at the same time that you install the additional 
product(s). 










Installing the Composite Tape 


If you are using the composite tape, you will find all three of the above listed sets 
of installation jobs on the tape. The jobs you will actually use, however, are 
designed to install all three products at once. These jobs begin with the prefix ‘P3’, 
and are located with the compiler installation files on the composite tape. 


Chapter 2, “Installing the Composite Product” on page 13, explains how to use 
the composite tape installation jobs (named ‘P3xxxx’) to install the transient and 
resident libraries and the compiler all at one time. 


Multiple Program Product Installation 


Attempting to RECEIVE the transient library, resident library, and compiler at the 
same time in a multiprogramming environment may, during installation, cause 
problems because of data set contention. You can prevent unnecessary enqueuing 
of jobs on a single data set by scheduling all SMP RECEIVE jobs to a single class 
and starting only one initiator to that class. This forces sequential processing of 
program product installation job streams, but allows maximum multiprogramming 
with your usual jobs. You must APPLY all the PL/I products you have selected 
for your site at the same time and with a single job. 
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Preparing for Installation 


There are several decisions you must make before beginning the installation 
process. 


Choosing Optional Subcomponents 


Before installing the transient or resident libraries or the composite product, you 
must decide whether you want multitasking support and/or CICS support at your 
site. You can find more information on multitasking support and CICS support in 
OS PL/I Optimizing Compiler: Programmer’s Guide. 


Before installing the compiler or the composite product, you must decide whether 
you want TSO support at your site. You can find more information on TSO 
support in OS PL/I Optimizing Compiler: TSO User’s Guide. 


You will use SMP control statements to choose or exclude these optional 
subcomponents during the installation process. 


Choosing Target Libraries 


The data sets into which you will install the executable OS PL/I code are called 
target libraries. Before allocating these data sets during the installation process, 
you must decide whether to use private libraries, system libraries, or a combination 
of the two. All the installation jobs provided on the distribution tape(s) refer to 
private libraries. If you choose to use system libraries, you must change the jobs to 
refer to the system libraries you have selected. 


We strongly recommend that, at least initially, you use private libraries as your 
target libraries, for the following reasons: 


e By installing the new release into private libraries, you can keep an earlier 
release as your active PL/I product while installing and verifying the current 
release. This is particularly important when installing release 5.1, for which the 
SMP +-+VER statement causes the deletion of any existing PL/I libraries 
unless the new release is installed into private target and SMP data sets. Later, 
you can make the current release your active product by: 


— Renaming and recataloging the private libraries 


— Moving the new modules from the private libraries to the appropriate 
system libraries, if you prefer to run PL/I from system libraries 


You must remember to change data set names within your PL/I and SMP 
procedures when making these changes. 


¢ If your site is using OS PL/I from private libraries at the time you generate a 


new operating system, it will be relatively easy to move OS PL/I to the new 
system. 
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Using Private Libraries 


If you decide to keep your OS PL/I product in private libraries, there are certain 
additional steps you will need to take during and after installation: 


e If you choose a private link library such as PLI.PLILINK, you must either add 
it to the LNKLSTnn member of SYS1.PARMLIB or add STEPLIB DD 
statements to your cataloged procedures for use at compile and execution time. 
Figure 15 on page 48 shows a job coded to run the PL/I sample program 
from private libraries using an in-stream procedure with appropriate STEPLIB 
DD statements added. 


e If you choose a private procedure library such as PL].LPROCLIB, you must use 
the proper JES start procedure to enable you to use either concatenated or 
alternate PROCLIBs, or you must use in-stream procedures in the jobs that 
refer to the cataloged procedures. 


e If you choose private resident library data sets such as PLI.LPLIBASE or 
PLI.PLITASK, you must change the OS PL/I procedures’ link-edit steps to 
refer to these names instead of to SYS1.PLIBASE and SYS1.PLITASK. 


e If you have selected the compiler’s TSO subcomponent, you must also consider 
the following: 


— If you use a private TSO command processor library such as 
PLI.CMDLIB, you must concatenate it to SYS1.CMDLIB by using 
STEPLIB DD statements within your LOGON procedure. If you use a 
private TSO HELP library such as PLI.LPLIHELP, you must concatenate it 
to SYS1.HELP after the SYSHELP DD statement within your LOGON 
procedure. Change the LOGON procedure after you install the compiler 
and before you attempt to use it. Note that private TSO libraries may 
adversely affect TSO system response time. 


— If you intend to invoke the OS PL/I compiler under TSO EDIT by using 
the RUN subcommand, you must give the resident library’s target data set 
the name SYS1.PLIBASE. 


Cataloged Procedures 


The distribution tapes provide cataloged procedures to invoke the OS PL/I 
compiler and libraries, and to install and maintain the product. Both are discussed 
here. 


Product Invocation Cataloged Procedures 


The product invocation cataloged procedures (such as PLIXC and PLIXCLG) are 
generalized for use in many system environments. You can use the SMP 
USERMOD facility to customize them for your site’s system environment. Some 
of the factors you must consider before modifying the cataloged procedures for 
your site follow. 


You must specify options for the PARM, UNIT, and SPACE parameters of the 
cataloged procedures, and you must establish the blocking factors for the output 
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data sets. You should choose these according to your site’s usual operating 
procedures. 


You must specify a minimum region size for compilation that is at least 8K bytes 
larger than the largest value that will be specified in the SIZE compiler option, 
excluding SIZE(MAX). The region size must be at least 128K or larger. 


If your system programmer has changed the linkage editor’s defaults for “‘value1” 
and/or “‘value2” of the SIZE option, consult your linkage editor and loader user’s 
guide for help in selecting an appropriate REGION parameter. If the linkage 
editor’s default is 256K for “‘value1” of the SIZE option, the linkage editor region 
size must be at least 256K in the cataloged procedures PLIXCL, PLIXCLG, and 
PLIXLG, which use the linkage editor. 


If your system programmer has changed the loader’s default for the SIZE option, 
consult your linkage editor and loader user’s guide for help in selecting an 
appropriate REGION parameter. If the loader’s default is 300K for the SIZE 
option, the loader region size must be at least 324K in the cataloged procedures 
PLIXCG, PLIXG, which use the loader. 


Product Installation and Maintenance Cataloged Procedures 


The distribution tapes include cataloged procedures that invoke SMP for use during 
product installation, modification, and maintenance. These procedures are 
designed to invoke SMP, but contain instructions that enable you to adapt them to 
invoke SMP/E. These procedures are described below: 


L5PROC You use this procedure in installing the transient library tape and in 
applying needed USERMODs at the time of installation. If you do 
not install the resident library or compiler on your system, you will 
also use this procedure in the future to modify and maintain your 
transient library. 


L4PROC You use this procedure in installing the resident library tape and in 
applying needed USERMODs at the time of installation. If you do 
not install the compiler on your system, you will also use the 
procedure in the future to modify and maintain both your transient 
and resident libraries. 


PIPROC You use this procedure in installing the compiler tape and in 
applying needed USERMODs at the time of installation. If you are 
installing the transient and resident libraries and the compiler using 
the three individual tapes, you will also use this procedure in the 
future to modify and maintain your transient and resident libraries 
and the compiler. 


P3PROC You use this procedure in installing the composite tape which 
contains the transient and resident libraries and the compiler. You 
use it in applying needed USERMODs at the time of installation, 
and you will also use it in the future to modify and maintain the 
transient and resident libraries and the compiler. 
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Changing Option Defaults and Customizing PL/I 


After you have installed OS PL/I on your system, it is ready for use. There are a 
few additional steps you can take at this time to customize your PL/I product for 
your site’s needs. 


IBM has supplied sets of default values for compiler options and for execution-time 
options that are automatically in effect when you invoke PL/I. If you want to 
change these default values, you can do so either at the time of installation or later 
using SMP’s USERMOD process. General users of OS PL/I can later override 
either the IBM-supplied default values or those new default values you have 
established. (Techniques for overriding option default values are documented in 
OS PL/I Optimizing Compiler: Programmer’s Guide.) You can also modify the 
PL/I-supplied error exit routine to issue an abend on abnormal termination of a 
PL/I program. 


Post Installation Tuning 


After installing PL/I, you can take certain steps to improve performance and/or 
reduce storage requirements for PL/I programs. 


The shared library facility provides a way to place frequently used resident library 
modules into an MVS shared library so that multiple PL/I programs executing 
concurrently in your system can refer to a single copy of the selected resident 
library modules. This technique can reduce overall storage requirements if a 
number of PL/I application programs execute concurrently, but can increase 
slightly the execution time of the PL/I programs. 


You can also select frequently used transient library modules to reside in the link 
pack area. This will assure that these modules are available when needed by 
executing application programs, and will eliminate the need to load these modules 
into storage each time they are needed. 


Program products such as IMS/VS and CICS give you the ability to specify a list of 


modules that can be preloaded in order to improve overall system performance. 
You might find it useful to preload commonly used PL/I library modules. 


Note: 





SMP does not keep track of modules in the shared library or in the link pack 
area. Therefore, if you apply to the resident or transient library, or to the 
CICS interface module DFHSAP, a program temporary fix (PTF) that affects 


a module in your shared library or in the link pack area, you must rebuild the 
shared library or recopy the affected module to the link pack area. 
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Chapter 2. Installing the Composite Product 


This chapter describes the procedure for installing the OS PL/I Transient Library, 
Resident Library, and Optimizing Compiler, as distributed in the composite 
package, product number 5734-PL3. If you are installing the composite package, 
you should read this entire chapter before attempting to perform any of the actions 
described here. If you are installing individual product component tapes, you 
should begin with Chapter 3, “Installing the Transient Library” on page 23. 


This chapter describes the contents of the composite distribution tape and gives the 
details of the following installation steps: 


1. Obtaining the JCL you need from the distribution tape 
2. Selecting your target libraries 
3. Establishing your site’s libraries 


4. Installing the compiler and libraries 


Distribution Tape Contents 


The OS PL/I Transient Library, Resident Library, and Optimizing Compiler, are 
distributed together on a standard labeled 9-track tape as product number 
5734-PL3. The compiler and libraries are also distributed individually on separate 
tapes as described in subsequent chapters of this book. The Program Directory 
distributed with each product tape describes the files on the tape. 


The composite product distribution tape contains the following information: 
« SMP control statements and JCLIN 
« Selected product source modules, including the: 


— Installation JCL 

— Cataloged procedures to invoke the product 

— Execution-time options module 

— Compiler options modules 

— Macros used by the options modules 

— Shared library macro 

— Sample program 

— Processing Program Table (PPT) entries for the optional CICS component 
(release 5.1 only) 

— HELP text for the optional TSO component 
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¢ Transient library load modules 
e Resident library load modules 
e Compiler load modules 


e« Transient and resident library load modules for the optional CICS component 
(release 5.1 only) 


¢ Transient and resident library load modules for the optional multitasking 
component 


« Compiler load modules for the optional TSO component 


Step 1: Obtaining the JCL You Need from the Distribution Tape 


The distribution tape contains installation JCL for installing the OS PL/I 
Optimizing Compiler and Libraries. These jobs are: 


P3ALLOC _ Allocates the distribution and target libraries. 
P3ALSMPE  Allocates and initializes SMP/E data sets. 
P3ALSMP4_ Allocates and initializes SMP data sets. 
P3PROC Adds an SMP procedure to PLIPROCLIB. 


P3RECEIV _ Receives the transient library, resident library, and optimizing 
compiler product subcomponents you choose. 


P3APPLY Applies the transient library, resident library, and optimizing 
compiler product subcomponents you choose. 


P3MOD Changes execution-time and compiler option defaults. 
The Program Directory distributed with the composite tape includes listings of the 
installation jobs listed above. If you want to use any of these jobs, however, either 


as they are or with your own modifications, you must copy them from the tape to a 
data set to which you have access. 


Making Your Copy of the Installation Jobs 


Figure 1 on page 15 shows a job that invokes the JEBCOPY utility program to 
copy the installation jobs from the distribution tape to a new temporary data set 
named PLI.INSTALL. 
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//P3GETJCL JOB 
//GETIJCL PROC 
//TAP2DSK EXEC 
//SYSPRINT DD 
Li* 
//* 
i7* 


NOTE: DSN, 


//* parameters 
//* 
//* 
//SYSUT1 DD 
// 
//SYSUT2 DD 
//SYSUT3 DD 
//SYSUT4 DD 
//ENDGET PEND 
//ALLOCAT EXEC 
/ /SAMPJICL DD 
// 
//* 
//* 
//* product release. 
//* parameters 
//* 
//* 
//TRANLIB EXEC 
COPY 
SELECT 
//RESLIB EXEC 


COPY 
SELECT 
//COMPILE EXEC 
COPY 
EXCLUDE 
//TSO EXEC 
COPY 
SELECT 
// 
Figure 1. 


product release. 


MSGLEVEL=(1,1) 
FILENUM=,FMID= 
PGM=IEBCOPY 
SYSOUT=A 


VOL, and LABEL parameters vary with each 
Validate the DSN, VOL, and LABEL 
of the following DD statement by referring 


to your Program Directory. 


DSN=&FMID. .F2, VOL=SER=APL51B, 
DISP=(SHR, PASS) ,UNIT=tape, 
LABEL= ( &F ILENUM, SL) 
DSN=PLI . INSTALL, DISP=OLD 
UNIT=SYSDA, SPACE=(TRK, (5,1)) 
UNIT=SYSDA, SPACE=(TRK, (5,1)) 


PGM=TEFBR14 
DSN=PLI . INSTALL, DISP=(,CATLG) , UNIT=SYSDA, 
VOL=SER=nnnnnn, SPACE=(CYL, (1,1,5)) 


NOTE: FILENUM and FMID parameters vary with each 


Validate the FILENUM and FMID 
of the following EXEC statements by 


referring to your Program Directory. 


GETJCL, FILENUM=3 , FMID=HTL1510 
INDD=SYSUT1, OUTDD=SYSUT2 
MEMBER= (IBMBXOPT) 

GETJCL, FILENUM=11,FMID=HRL1510 
INDD=SYSUT1,OUTDD=SYSUT2 
MEMBER= (PLIXG, PLIXLG) 

GETJCL, FILENUM=18 , FMID=HPL1510 
INDD=SYSUT1 , OUTDD=SYSUT2 
MEMBER= (PLIXOPB) 

GETJCL, FILENUM=21,FMID=JPL1514 
INDD=SYSUT1 , OUTDD=SYSUT2 
MEMBER= (IELOAT) 


Job to Copy Installation Jobs from Composite Product Distribution Tape 





When you have copied the installation jobs to your PLIINSTALL data set, you 
can print them for review or obtain copies that you can modify for use in later steps 
of the composite product installation process. Figure 2 on page 16 shows a job 
that invokes the IEBPTPCH utility program to print all the members of the 
PLILINSTALL data set. 
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//LISTICL JOB MSGLEVEL=(1,1) 

//LISTALL EXEC PGM=IEBPTPCH 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSN=PLI.INSTALL, DISP=SHR 

//SYSUT2 DD SYSOUT=A 
PRINT TYPORG=PO,MAXFLDS=1 
RECORD FIELD=(80) 

// 


Figure 2. Job to Print All Jobs in the PLILINSTALL Data Set 





In order to use one of the jobs in the PLILINSTALL data set, you must modify its 
JOB statement to meet your site’s JCL requirements. You might also need to 
modify other parts of the job. This chapter outlines these modifications. 


When your installation is complete and you have ACCEPTed your product, you 
can erase PLIINSTALL. ACCEPT processing puts the installation jobs into the 
distribution library, PLI.PL141S. 


Step 2: Selecting Target Libraries 


You must choose either private or system libraries into which to install your OS 
PL/I product. These libraries are referred to as target libraries. “‘Preparing for 
Installation” on page 8 gives information about system and private libraries and 
how to choose target libraries. The following table shows the various target 
libraries you can choose for the OS PL/I product components: 


Component Private Library System library 
Transient library PLI.PLILINK SYS1.LINKLIB 
required modules PLI.LPROCLIB_ | SYS1.PROCLIB 
Resident library PLI.PLIBASE SYS1.PLIBASE 
required modules PLI.LISHRMAC | SYS1.SHRMAC 
Optimizing compiler required PLI.LPLICOMP | SYS1.LINKLIB 
load modules 

Resident library optional PLI.PLITASK SYS1.PLITASK 
multitasking component 

Transient library optional CICS PLI.PLILINK SYS1.LINKLIB 
component (release 5.1 only) 

Transient library optional CICS PLI.SAMPLIB_ | SYS1.SAMPLIB 
PPT entries (release 5.1 only) 

Resident library optional CICS PLI.PLIBASE SYS1.PLIBASE 
component (release 5.1 only) 

Optimizing compiler optional PLI.CMDLIB SYS1.CMDLIB 
TSO load modules 
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Private Library | System library 


Optimizing compiler optional PLI.HELP SYS1.HELP 
TSO HELP text 


Sample program PLI.SAMPLIB- | SYS1.SAMPLIB 


If you want to use an existing library but adequate space is not available, you can 
reallocate the existing library using the move/copy utility routine, IEHMOVE. 






Note: If you use an existing library, you must remember that, with release 5.1, 
SMP uses the DELETE operand of the ++VER control statement to replace the 
contents of the existing product data sets. 


During the installation process, SMP will link-edit or copy load modules from the 
distribution tape into your target libraries. It will also copy product invocation 
cataloged procedures into your PROCLIB target library. 


Step 3: Establishing Your Site’s Libraries 


The installation jobs you copied into your PLI.INSTALL data set include all the 
jobs necessary to install the transient and resident libraries and the compiler. 


Allocating Product Data Sets 


You can use the P3 ALLOC job from PLLINSTALL to allocate and catalog the OS 
PL/I target libraries and distribution libraries. 


Space requirements for the OS PL/I data sets are specified in the PSALLOC 
installation JCL in terms of blocks. You can use the space allocations as they are 
shown, or you can convert them to cylinder or track allocations according to the 
type of DASD device onto which you will install the product. Accurate DASD 
space requirements for different device types are listed in the Program Directory in 
terms of tracks. 


Note: 





Before you run the job to allocate storage for the composite product, verify 
that the total amount of space needed is available on the DASD device you 


have chosen. In addition, if you plan to use the shared library, you should 
double the storage allocation for PLI.PLIBASE. 


You can find more information on the shared library in “Using the Shared Library” 
on page 81. 


You can obtain the P3 ALLOC in-stream procedure using the job shown in 
Figure 3 on page 18 and customize it for your site’s needs by changing symbolic 
parameter defaults in the PROC statement of the procedure or by overriding the 
defaults in the EXEC statement that invokes the procedure. 
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//PUNCHJCL JOB MSGLEVEL=(1,1) 
//PUNCHIT EXEC PGM=IEBGENER 


//SYSIN DD DUMMY 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD DSN=PLI.INSTALL(P3ALLOC) , DISP=SHR 


//SYSUT2 DD SYSOUT=B, DCB= (RECFM=F, LRECL=80, BLKSIZE=80) 


Figure 3. Job to Obtain the PSALLOC Member of Installation JCL 


If you have chosen to use system libraries as your target libraries, you must delete 
from P3ALLOC the DD statements for the corresponding private libraries. For 
example, if you have chosen to use SYS1.LINKLIB as your target link library, you 
must delete the DD statement for PLI.PLILINK;; if you have chosen to use 
SYS1.PROCLIB as your target procedure library, you must delete the DD 
statement for PLILPROCLIB, and so on. 


If you do not plan to use OS PL/I’s multitasking component, you must delete the 
DD statement for PLITASK. If you do not plan to use OS PL/I’s TSO component, 
you must delete the DD statements for CMDLIB and HELP. 


When you have finished modifying PSALLOC according to your needs, you can 
execute the P3 ALLOC job. 


Allocating SMP Data Sets 


You can use another installation job from PLI.INSTALL to allocate and initialize 
your SMP data sets. Use PSALSMP4 if you use SMP at your site, or PPALSMPE 
if you use SMP/E. 


You can customize P3 ALSMPn for your site’s needs by changing symbolic 
parameter defaults in the PROC statement of the procedure or by overriding the 
defaults in the EXEC statement that invokes the procedure. You must also 
examine the comment statements in the job to determine additional changes you 
must make. 


Space requirements for the SMP data sets are specified in P3ALSMPn in terms of 
blocks. You can use the space allocations as they are shown, or you can convert 
them to cylinder or track allocations according to the type of DASD device onto 
which you will install the product. Accurate DASD space requirements for 
different device types are listed in the Program Directory in terms of tracks. 


Note: 





Before you run the job to allocate storage for the SMP data sets, verify that 
the total amount of space needed is available on the DASD device you have 


chosen. 
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You can obtain either P3 ALSMP4 or PSALSMPE by using the PUNCHICL job 
shown in Figure 3 on page 18. Replace the name ‘P3ALLOC’ in the SYSUT1 
DD statement with the name of the member that corresponds to the version of 
SMP used at your site. 


Adding the Cataloged Procedure to Install 


You can use the P3PROC job from PLI.INSTALL to place the P3PROC cataloged 
procedure into PLILPROCLIB. The P3PROC procedure is used by PSRECEIV 
and P3APPLY, which install the transient and resident libraries and the compiler, 
and also by P3MOD if you choose to change the IBM-supplied execution-time 
and/or compiler option defaults. 


Before placing P3PROC into PLI.LPROCLIB, you can customize it for your site’s 
needs by changing symbolic parameter defaults in the PROC statement of the 
procedure. You can identify, by comments in the P3PROC job, the JCL 
statements that are specific to SMP or SMP/E; use those statements that match 
your site’s version of SMP. 


The data set names in the target library DD statements must match the names you 
have selected for your site. If you decided to use system libraries as your target 
libraries, you must change the DSN portions of the corresponding DD statements 
to specify the appropriate system libraries. If you decided not to use the 
multitasking component, delete the PLITASK DD statement. If you decided not to 
use the TSO component, delete the CMDLIB and HELP DD statements. 


You can obtain the P3PROC installation job by using the PUNCHJCL job shown 
in Figure 3 on page 18. Just replace the data set member name in the SYSUT1 
DD statement with the name ‘P3PROC’. 


Step 4: Installing the Distribution Tape 


When you have run the jobs to allocate the transient library, resident library, and 
compiler data sets, allocate and initialize the SMP data sets, and add P3PROC to 
your procedure library, you are ready to install the distribution tape. You can use 
the PSRECEIV job from PLI.INSTALL to RECEIVE the OS PL/I Optimizing 
Compiler composite product, and the P3 APPLY job to APPLY it. 


If you are using SMP to install, you can find more information about the 
RECEIVE and APPLY procedures in OS/VS System Modification Program (SMP) 
System Programmer's Guide. If you are using SMP/E to install, you can find more 
information about the RECEIVE and APPLY procedures in SMP/E User’s Guide, 
and SMP/E Reference. You also have the option of using the interactive capability 
of SMP/E to install rather than the batch procedure described here. This is 
described in SMP/E Terminal User’s Guide. 
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RECEIVE ing the Composite Product 


Job P3RECEIV invokes P3PROC to RECEIVE compiler and library data sets 
from the distribution tape into temporary data sets allocated by SMP. If you 
installed P3PROC into private procedure library PLILPROCLIB, you must use the 
proper JES start procedure to enable you to use concatenated or alternate 
PROCLIBs, or insert P3PROC, ended by a // PEND statement, into PPRECEIV 
as an in-stream procedure. 


If you want to override some of P3PROC’s symbolic parameters, you can do so 
with the EXEC PROC statement you use in PSRECEIV to execute P3PROC. 


You must also verify the UNIT parameter in the SMPPTFIN DD statement in 
P3RECEIV. Several DD statements are provided and represent the possible 
combinations of product function and SMP level. These are identified by the 
comments accompanying them. You must select the group of input data that 
matches your OS PL/I product components and your SMP product. Change the 
DDNAME on the single matching //SMPnnn DD * statement to SMPCNTL. The 
other DD statements in this job will have no effect. 


When you have finished modifying PS3RECEIV according to your site’s needs, you 
can execute the PSRECEIV job. 


APPLYing the Composite Product 


Remember to adjust for using a private procedure library by using the appropriate 
JES start procedure or inserting P3PROC into PSAPPLY. You can, if you want to, 
use the EXEC PROC statement in P3APPLY to override P3PROC’s symbolic 
parameters 


P3APPLY provides several DD statements that represent the possible 
combinations of transient and resident library and optimizing compiler functions 
and SMP level. You can identify these by the comments that accompany them. 
You must select the group of input data that matches your PL/I product 
components and your SMP product. Change the DDNAME on the single matching 
//SMPnnn DD * statement to SMPCNTL. The other DD statements in PSAPPLY 
will have no effect. 


When you have finished modifying PS APPLY according to your site’s needs, you 
can execute the PSAPPLY job. 


Note: During the execution of P3 APPLY, you will receive the following messages 
from the linkage editor: 


IEWO461 SYMBOL PRINTED IS AN UNRESOLVED EXTERNAL REFERENCE 
IEWO342 ERROR - LIBRARY SPECIFIED DOES NOT CONTAIN MODULE 


IEW0461 is issued during the link-edit of compiler module IELOPA. You should 
ignore the unresolved external reference to IEAXPALL because this module is not 
used in either an MVS or MVS/XA environment. 


IEW0461 is also issued during the link-edit of some of the resident library modules. 


These references will later be resolved when a compiled application program is 
link-edited. 
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IEW0342, which sets return code 08, is issued because SMP attempts to include, 
from the target library, members that do not yet exist. These messages are normal 
during initial installation. 


Verifying Correct Installation 


After P3 APPLY has executed correctly, the PL/I transient library, resident library, 
and optimizing compiler are ready for use. You will probably want to run the 
sample program to test the success of the installation process. See 

Chapter 6, “Running the Installation Verification Program” on page 47. 


ACCEPTing the OS PL/I Product 


You will probably want to try out your new compiler and libraries for a while 
before you execute an SMP ACCEPT command to permanently install the product. 
You must, however, ACCEPT the product before you attempt to install any 
maintenance or USERMODs, as you will not be able to RESTORE the product to 
its previous level (in the event of a problem) if you have not previously executed 
the SMP ACCEPT command against the product itself. 


You can easily modify PSAPPLY to ACCEPT the product: 
« If you are using SMP, just change the APPLY statement to ACCEPT. 


¢ For SMP/E, change the APPLY statement to ACCEPT, and change the target 
zone designation from PLITGT to PLIDLIB. 


Completing Installation of CICS Support 


If you have chosen to install PL/I release 5.1’s support for CICS, there are some 
additional steps you must take after ACCEPTing your PL/I products to connect 
the transient and resident library CICS components to the CICS product. These 
steps are described in Chapter 7, ‘“Completing Installation of PL/I Support for 
CICS” on page 51. 


Customizing and Tuning Your OS PL/I Product 


You can customize your PL/I product by changing the default values supplied by 
IBM for the execution-time and compiler options. You can also modify the PL/I 
error exit routine to issue an abend on abnormal termination of a PL/I program. 
Chapter 8, “Changing Option Defaults and Customizing PL/I’’ on page 55 
describes the options and their IBM-supplied default values, and explains how to 
change the defaults according to the needs of your site. It also describes how to 
modify the error exit routine. 


You can also use the shared library, add transient library modules to the link pack 
area, and disable PL/I’s fast initialization facility if storage for PL/I program load 
modules is limited. These procedures are discussed in Chapter 9, ‘‘Postinstallation 
Tuning” on page 81. 
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Chapter 3. Installing the Transient Library 


This chapter describes the procedure for installing the OS PL/I Transient Library. 
If you are installing the individual transient library tape, you should read this entire 
chapter before attempting to perform any of the actions described here. If you are 
installing the composite tape that contains the transient and resident libraries and 
the compiler, you should use the procedures described in Chapter 2, “Installing 
the Composite Product” on page 13 to install the product. 


This chapter describes the contents of the distribution tape and gives the details of 
the following installation steps: 


1. Obtaining the JCL you need from the distribution tape 
2. Selecting your target libraries 
3. Establishing your site’s libraries 


4. Installing the transient library 


Distribution Tape Contents 


The OS PL/I Transient Library is distributed on a standard labeled 9-track tape as 
product number 5734-LM5 or as part of the composite product number 5734-PL3, 
which also includes the Resident Library and the Optimizing Compiler. The 
Program Directory distributed with each product tape describes the files on the 
tape. 


The Transient Library distribution tape contains the following information: 
e SMP control statements and JCLIN 
¢ Selected transient library source modules, including the: 
— Installation JCL 
— Execution-time options module 
— Macro used by the options module 
— Processing Program Table (PPT) entries for the optional CICS component 
(release 5.1 only) 


e Transient library load modules 
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e Transient library load modules for the optional CICS component (release 5.1 
only) 


e Transient library load modules for the optional multitasking component 


Step 1: Obtaining the JCL You Need from the Distribution Tape 


The distribution tape provides JCL for installing the transient library. The job 
names and their descriptions follow: 


L5ALLOC _ Allocates the distribution and target libraries. 

LSALSMPE Allocates and initializes SMP/E data sets. 

LSALSMP4  Allocates and initializes SMP data sets. 

L5PROC Adds an SMP procedure to PLI.LPROCLIB. 

LS5SRECEIV _ Receives the transient library product subcomponents you choose. 
LS5SAPPLY Applies the transient library product subcomponents you choose. 
L5MOD Changes execution-time options defaults. 

The Program Directory distributed with the product tape includes listings of the 
installation jobs listed above. If you want to use any of the jobs, however, either as 


they are or with your own modifications, you must copy them to a data set to which 
you have access. 


Making Your Copy of the Installation Jobs 


Figure 4 on page 25 shows a job that invokes the IEBCOPY utility program to 
copy the installation jobs from the distribution tape to a new temporary data set 
named PLI.INSTALL. 
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//LSGETICL JOB MSGLEVEL=(1, 1) 
//TAP2DSK EXEC PGM=IEBCOPY 
//SYSPRINT DD SYSOUT=A 
//* 
//* NOTE: DSN and VOL parameters vary with each product 
//* release. Validate the DSN and VOL parameters of the 
//* following DD statement in your Program Directory. 
//* 
//SYSUT1 DD DSN=HTL1510.F2,VOL=SER=ATLS1A, 
// DISP=SHR,UNIT=tape, LABEL=(3,SL) 
//SYSUT2 DD DSN=PLI.INSTALL, DISP=(,CATLG) , UNIT=SYSDA, 
J / VOL=SER=nnnnnn,SPACE=(CYL, (1,1,5)) 
//SYSUT3 DD UNIT=SYSDA, SPACE=(TRK, (5,1) ) 
//SYSUT4 DD UNIT=SYSDA,SPACE=(TRK, (5,1) ) 
COPY INDD=SYSUT1 , OUTDD=SYSUT2 

EXCLUDE MEMBER=(PLTRLIB) 

// 


Figure 4. Job to Copy Installation Jobs from the Transient Library Tape 





When you have copied the installation jobs to your PLLINSTALL data set, you 
can print them for review or obtain copies that you can modify for use in later steps 
of the transient library installation process. Figure 5 shows a job that invokes the 
IEBPTPCH utility program to print all the jobs in the PLI.INSTALL data set. 





//LISTICL JOB MSGLEVEL=(1,1) 
//LISTALL EXEC PGM=IEBPTPCH 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD DSN=PLI .INSTALL, DISP=SHR 
//SYSUT2 DD SYSOUT=A 
PRINT TYPORG=PO,MAXFLDS=1 
RECORD FIELD=(80) 
// 


Figure 5. Job to Print All the Jobs in the PLI.INSTALL Data Set 


In order to use one of the jobs in the PLI.IINSTALL data set, you must mod'fy its 
JOB statement to meet your site’s JCL requirements. You might also need to 
modify other parts of the job. Such modifications are described in the remainder of 
this chapter. 


When your installation is complete and you have ACCEPTed your product, you 


can erase PLIINSTALL. ACCEPT processing puts the installation jobs into the 
distribution library, PLI.LM541S. 
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Step 2: Selecting Target Libraries 


You must select either private or system link and procedure libraries into which you 
will install the transient library. These libraries are referred to as target libraries. 
See “Preparing for Installation’ on page 8 for more information about system and 
private libraries and how to choose target libraries. The following table shows the 
various target libraries you can choose for the transient library: 


Private Library _| System library 
Transient library PLI.PLILINK SYS1.LINKLIB 
required modules PLI.LPROCLIB_ | SYS1.PROCLIB 
Transient library optional PLI.PLILINK SYS1.LINKLIB 
multitasking component 
Transient library optional CICS PLI.PLILINK SYS1.LINKLIB 
component (release 5.1 only) 

Transient library optional CICS PLI.SAMPLIB_ | SYS1.SAMPLIB 
PPT entries(release 5.1 only) 


If you want to use an existing library but adequate space is not available, you can 
reallocate the existing library, using the move/copy utility routine, IEHMOVE. 











Note: If you are installing into an existing library, you must remember that, with 
release 5.1, SMP uses the DELETE operand of the ++VER control statement to 
replace the contents of the existing product data set. 


During the installation process, SMP will link-edit or copy load modules from your 
distribution tape into your target libraries. 


Step 3: Establishing Your Site’s Libraries 


The installation jobs you copied into your PLILINSTALL data set include all the 
jobs necessary to install the transient library. 


Allocating Transient Library Data Sets 


You can use the LSALLOC job from PLLINSTALL to allocate and catalog the OS 
PL/I Transient Library target libraries and distribution libraries. 


Space requirements for the transient library modules are specified in the 
LSALLOC installation job in terms of blocks. You can use the space allocations as 
they are shown, or you can convert them to cylinder or track allocations according 
to the type of DASD device onto which you will install the transient library. 
Accurate DASD space requirements for different device types are listed in the 
Program Directory in terms of tracks. 
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Note: 





Before you run the job to allocate storage for the transient library, verify that 
the total amount of space needed is available on the DASD device you have 


chosen. 


You can obtain the LSALLOC in-stream procedure using the job shown in 
Figure 6, then customize it for your site’s needs by changing symbolic parameter 
defaults in the PROC statement of the procedure or by overriding the defaults in 
the EXEC statement that invokes the procedure. If you have chosen to use 
SYS1.LINKLIB as your target link library, you must delete the DD statement for 
PLI.PLILINK before executing LSALLOC. If you have chosen to use 
SYS1.PROCLIB as your target procedure library, you must delete the DD 
statement for PLILPROCLIB before executing LSALLOC. 


If you are installing the PL/I release 5.1 support for CICS, we strongly recommend 
that you install the transient library CICS load modules into the private library 
PLI.PLILINK, and the CICS PPT entries into the private library PLISAMPLIB. 
The procedures for enabling CICS to communicate with PL/I are discussed in 
Chapter 7, “Completing Installation of PL/I Support for CICS” on page 51. If 
you choose, however, to install the CICS modules into system rather than private 
libraries, you must delete the DD statements for PLI.LPLILINK and PLILSAMPLIB. 


When you have finished modifying LSALLOC according to your needs, you can 
execute the LSALLOC job. 





//PUNCHJCL JOB MSGLEVEL=(1, 1) 
//PUNCHIT EXEC PGM=IEBGENER 


//SYSIN DD DUMMY 
//SY¥SPRINT DD SYSOUT=A 
//SYSUT1 DD DSN=PLI.INSTALL (L5ALLOC) , DISP=SHR 


//SYSUT2 DD SYSOUT=B , DCB= (RECFM=F , LRECL=80 , BLKSIZE=80) 
// 


Figure 6. Job to Obtain LSALLOC Installation Job 


Allocating SMP Data Sets 


You can use another installation job from PLIL.INSTALL to allocate and initialize 
your SMP data sets. Use LSALSMP4 if you use SMP at your site, or LSALSMPE 
if you use SMP/E. 


You can customize the LSALSMPn in-stream procedure for your site’s needs by 
changing symbolic parameter defaults in the PROC statement of the procedure or 
by overriding the defaults in the EXEC statement that invokes the procedure. 
Read all the comments in LSALSMPn to determine the other changes you must 
make to the job. 


Space requirements for the SMP data sets are specified in the LSALSMPn 
installation job in terms of blocks. You can use the space allocations as they are 
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shown, or you can convert them to cylinder or track allocations according to the 
type of DASD device onto which you will install the libraries. Accurate DASD 
space requirements for different device types are listed in the Program Directory. 


Note: 





Before you run the job to allocate storage for the SMP data sets, verify that 
the total amount of space needed is available on the DASD device you have 


chosen. 


You can obtain either LSALSMP4 or LSALSMPE by using the PUNCHJCL job 
shown in Figure 6 on page 27. Just replace the name ‘LSALLOC’ in the SYSUT1 
DD statement with the name of the job that corresponds to the version of SMP 
used at your site. 


Adding the Cataloged Procedure to Install 


You can use the LSPROC job in PLI.INSTALL to place the LSPROC cataloged 
procedure into PLILPROCLIB. The LSPROC procedure is used by LSRECEIV 
and LSAPPLY, which install the transient library, and also by LSMOD, if you 
choose to change the IBM-supplied execution-time option defaults. 


You can customize the LSPROC job for your site’s needs by changing symbolic 
parameter defaults in the PROC statement of the procedure. You can identify, by 
comments in the job, the LSPROC JCL statements that are specific to SMP or 
SMP/E; use those statements that match your site’s version of SMP. The target 
library name in the PLILINK DD statement must match the name you have 
selected for your site. 


If you chose the system link library (SYS1.LINKLIB) as your target link library, 
you must change the DSN portion of the PLILINK statement to specify 
SYS1.LINKLIB. If you chose the system procedure library (SYS1.PROCLIB) as 
your target procedure library, you must change all occurrences of PLI.LPROCLIB to 
specify SYS1.PROCLIB. 


You can obtain the LSPROC installation job by using the PUNCHIJCL job shown 
in Figure 6 on page 27. Just replace the data set member name in the SYSUT1 
DD statement with the name ‘LSPROC’. 


Step 4: Installing the Distribution Tape 


When you have run the jobs to allocate the transient library data sets, to allocate 
and initialize the SMP data sets, and to place LSPROC in your procedure library, 
you are ready to install the distribution tape. You can use the LSRECEIV job 
from PLI.INSTALL to RECEIVE the OS PL/I Transient Library product, and the 
LSAPPLY job to APPLY it. 
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If you are using SMP to install, you can find more information about the 
RECEIVE and APPLY procedures in OS/VS System Modification Program (SMP) 
System Programmer's Guide. If you are using SMP/E to install, you can find more 
information about the RECEIVE and APPLY procedures in SMP/E User’s Guide, 
and SMP/E Reference. You also have the option of using the interactive capability 
of SMP/E to install rather than the batch procedure described here. This is 
described in SMP/E Terminal User’s Guide. 


RECEIVEing the Transient Library 


Job LSRECEIV invokes LSPROC to RECEIVE transient library data sets from 
the distribution tape into temporary data sets allocated by SMP. If you installed 
L5PROC into private procedure library PLILPROCLIB, you must use the proper 
JES start procedure to enable you to use concatenated or alternate PROCLIBs, or 
insert LSPROC, ended by a // PEND statement, into LSRECEIV as an in-stream 
procedure. 


If you want to override some of LSPROC’s symbolic parameters, you can do so 
with the EXEC PROC statement you use in LSRECEIV to execute LSPROC. 


You must also verify the UNIT parameter in the SMPPTFIN DD statement in 
LSRECEIV. Several DD statements are provided and represent the possible 
combinations of transient library function and SMP level. These are identified by 
the comments accompanying them. You must select the grouping of input data that 
matches the transient library component(s) you have chosen and your SMP 
product. Change the DDNAME on the single matching //SMPnnn DD * 
statement in LSRECEIV to SMPCNTL. The other DD statements in this job will 
have no effect. 


When you have finished modifying LSRECEIV according to your site’s needs, you 
can execute the LSRECEIV job. 


APPLY ing the Transient Library 


Note: 





If you are also installing the resident library or the resident library and 
optimizing compiler, do not run LSAPPLY. Instead, turn now to 
Chapter 4, “Installing the Resident Library” on page 31. If you are 


installing only the transient library, continue with the remaining instructions 
in this chapter. 


Remember to adjust for using a private procedure library by using the appropriate 
JES start procedure or by inserting LSPROC into LSAPPLY. You can, if you 
wish, use the EXEC PROC statement in LSAPPLY to override LSPROC’s 
symbolic parameters. 


LSAPPLY provides several DD statements that represent the possible 
combinations of transient library function and SMP level. You can identify these 
by the comments that accompany them. You must select the group of input data 
that matches the transient library components you have chosen and your SMP 
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product. Change the DDNAME on the single matching //SMPnnn DD * 
statement to SMPCNTL. The other DD statements in LSAPPLY will have no 
effect. When you have finished modifying LSAPPLY according to your site’s 
needs, you can execute the LSAPPLY job. 


Note: During execution of LSAPPLY, you will receive the following message from 
the linkage editor: 


IEWO342 ERROR - LIBRARY SPECIFIED DOES NOT CONTAIN MODULE 


This message, which sets return code 08, is issued because SMP attempts to 
include, from the target library, members that do not yet exist. This message is 
normal during initial installation. 


ACCEPTing the Transient Library 


You will probably want to try out your new transient library for a while before you 
execute an SMP ACCEPT command to permanently install the product. You must, 
however, ACCEPT the product before you attempt to install any maintenance or 
USERMODs, as you will not be able to RESTORE the product to its previous level 
(in the event of a problem) if you have not previously executed the ACCEPT 
command against the product itself. 


You can easily modify LSAPPLY to ACCEPT the product: 


e If you are using SMP, change the APPLY statement to ACCEPT. 
¢ If you are using SMP/E, change the APPLY statement to ACCEPT and 
change the target zone designation from PLITGT to PLIDLIB. 


Completing Installation of CICS Support 


If you have chosen to install PL/I release 5.1’s support for CICS, there are some 
additional steps you must take after ACCEPTing your PL/I transient library to 
connect its CICS component to the CICS product. These steps are described in 
Chapter 7, “Completing Installation of PL/I Support for CICS” on page 51. 


Customizing and Tuning Your OS PL/I Product 


You can customize your transient library by changing the default values supplied 
by IBM for the execution-time options. Chapter 8, “Changing Option Defaults 
and Customizing PL/I” on page 55 describes the options and their IBM-supplied 
default values, and explains how to change the defaults according to the needs of 
your site. 


You can also add transient library modules to the link pack area and disable PL/I’s 
fast initialization facility if storage for PL/I program load modules is limited. 
These procedures are discussed in Chapter 9, ‘‘Postinstallation Tuning” on 

page 81. 
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Chapter 4. Installing the Resident Library 


This chapter describes the procedure for installing the OS PL/I Resident Library. 
If you are installing the individual resident library tape, you should read this entire 
chapter before attempting to perform any of the actions described here. If you are 
installing the composite tape that includes the transient library and compiler, you 
should use the procedures outlined in Chapter 2, “Installing the Composite 
Product” on page 13 to install the product. 


This chapter describes the contents of the distribution tape and gives the details of 
the following installation steps: 


1. Obtaining the JCL you need from the distribution tape 
2. Selecting your target libraries 
3. Establishing your site’s libraries 


4. Installing the resident library 


Note: 





You must run the transient library installation jobs through the LSRECEIV 
job before you begin installing the resident library. If you have previously 
installed the transient library (that is, you have run the LSAPPLY job), and 


you now want to install the resident library, you must first reinstall the 
transient library through the LSRECEIV step before you install the resident 
library. 


Distribution Tape Contents 


The OS PL/I Resident Library is distributed on a standard labeled 9-track tape as 
product number 5734-LM4 or as part of the composite product number 5734-PL3, 
which includes the Transient Library and the Optimizing Compiler. The Program 
Directory distributed with each product tape describes the files on the tape. 
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The Resident Library distribution tape contains the following information: 


SMP control statements and JCLIN 

Selected resident library source modules, including the: 
— Installation JCL 

— Cataloged procedures to invoke the product 

— Shared library macro 


Resident library load modules 


Resident library load modules for the optional CICS component (release 5.1 
only) 


Resident library load modules for the optional multitasking component 


Step 1: Obtaining the JCL You Need from the Distribution Tape 


The distribution tape provides JCL for installing the resident library. The job 
names and their descriptions follow: 


L4ALLOC _ Allocates the distribution and target libraries. 


L4PROC Adds an SMP procedure to PLILPROCLIB. 


L4RECEIV _ Receives the resident library product components you choose. 


L4APPLY Applies the transient library and resident library products you have 


chosen. 


The Program Directory distributed with the product tape includes listings of the 
installation jobs listed above. If you want to use any of the jobs, however, either as 
they are or with your own modifications, you must copy them to a data set to which 
you have access. 


Making Your Copy of the Installation Jobs 


Figure 7 on page 33 shows a job that invokes the IEBCOPY utility program to 
copy the installation jobs from the distribution tape to the existing temporary data 
set named PLI.INSTALL, which you created during the installation of the transient 
library. 
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//LAGETJCL JOB MSGLEVEL=(1,1) 

//TAP2DSK EXEC PGM=IEBCOPY 

//SYSPRINT DD SYSOUT=A 

//* 

//* NOTE: DSN and VOL parameters vary with each product 
//* release. Validate the DSN and VOL parameters of the 
//* following DD statement in your Program Directory. 


//* 
//SYSUT1 DD DSN=HRL1510.F2,VOL=SER=ARLS1A, 
// DISP=SHR,UNIT=tape, LABEL=(3,SL) 


//SYSUT2 DD DSN=PLI.INSTALL, DISP=OLD 
//SYSUT3 DD UNIT=SYSDA,SPACE=(TRK, (5,1) ) 
//SYSUT4 DD UNIT=SYSDA,SPACE=(TRK, (5,1) ) 
COPY INDD=SYSUT1,OUTDD=SYSUT2 
EXCLUDE MEMBER=(PLRSHR) 
// 


Figure 7. Job to Copy Installation Jobs from the Resident Library Tape 





When you have copied the installation jobs to your PLILINSTALL data set, you 
can print them for review or obtain copies that you can modify for use in later steps 
of the resident library installation process. Figure 8 shows a job that invokes the 
IEBPTPCH utility program to print all the jobs in the PLIINSTALL data set. 


//LISTICL JOB MSGLEVEL=(1, 1) 

//LISTALL EXEC PGM=IEBPTPCH 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSN=PLI.INSTALL, DISP=SHR 

//SYSUT2 DD SYSOUT=A 
PRINT TYPORG=PO, MAXFLDS=1 
RECORD FIELD=(80) 

// 


Figure 8. Job to Print All the Jobs in the PLI.INSTALL Data Set 





In order to use one of the jobs in the PLI.INSTALL data set, you must modify its 
JOB statement to meet your site’s requirements. You might also need to modify 
other parts of the job. Such modifications are described in the remainder of this 
chapter. 


When your installation is complete and you have ACCEPTed your product, you 
can erase PLI.INSTALL. ACCEPT processing puts the installation jobs into the 
distribution library, PLI.LM441S. 


Step 2: Selecting Target Libraries 


You must select either a private or system library as a target library to which you 
will install the resident library. (See “‘Preparing for Installation” on page 8 for 
more information about system and private libraries and how to choose a target 
library.) The following table shows the various target libraries you can choose for 
the resident library: 
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System library 
Resident library PLI.PLIBASE SYS1.PLIBASE 
required modules PLI.SHRMAC | SYS1.SHRMAC 
Resident library optional PLI.PLITASK SYS1.PLITASK 
multitasking component 
Resident library optional CICS PLI.PLIBASE SYS1.PLIBASE 
component (release 5.1 only) 


If you want to use an existing library but adequate space is not available, you can 
reallocate the existing library using the move/copy utility routine, EHMOVE. 








Note: If you use an existing library, you must remember that, with release 5.1, 
SMP uses the DELETE operand of the ++VER control statement to replace the 
contents of the existing product data set. 


During the installation process, SMP will link-edit or copy load modules from your 
distribution tape into your target libraries. It will also copy product invocation 
cataloged procedures into the PROCLIB target library you selected during 
transient library installation. 


If you require multitasking support and have installed the multitasking component 
of the transient library, you must install the multitasking component of the resident 
library into your PLITASK target library. 


If you require CICS support and have installed the release 5.1 CICS component of 
the transient library, you must install the CICS component of the resident library 
into your PLIBASE target library. 


Step 3: Establishing Your Site’s Libraries 


The installation jobs you copied into your PLI.INSTALL data set include all the 
jobs necessary to install the resident library. 


Allocating Resident Library Data Sets 


You can use the L4ALLOC job from PLI.INSTALL to allocate and catalog the OS 
PL/I Resident Library target libraries and distribution libraries. 


Space requirements for the resident library modules are specified in the L4ALLOC 
installation JCL in terms of blocks. You can use the space allocations as they are 
shown, or you can convert them to cylinder or track allocations according to the 
type of DASD device onto which you are installing the libraries. Accurate DASD 
space requirements for different device types are listed in the Program Directory in 
terms of tracks. 
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Note: 





Before you run the job to allocate storage for the resident library, verify that 
the total amount of space needed is available on the DASD device you have 


chosen. In addition, if you plan to use the shared library, you should double 
the storage allocation for PLI.PLIBASE. 


You can find more information on the shared library in ‘Using the Shared Library” 
on page 81. 


You can obtain the L4¢ALLOC in-stream procedure using the job shown in 
Figure 9, then customize it for your site’s needs by changing symbolic parameter 
defaults in the PROC statement of the procedure or by overriding them in the 
EXEC statement that invokes the procedure. 


If you do not plan to use OS PL/I’s multitasking component, you must delete the 
DD statement for PLITASK. 


When you have finished modifying L4ALLOC according to your needs, you can 
execute L4ALLOC. 





//PUNCHJCL JOB MSGLEVEL= (1,1) 

//PUNCHIT EXEC PGM=IEBGENER 

//SYSIN DD DUMMY 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSN=PLI. INSTALL (L4SALLOC) , DISP=SHR 
//SYSUT2 DD SYSOUT=B , DCB= (RECFM=F , LRECL=80 , BLKSIZE=80) 
// 


Figure 9. Job to Obtain L4ALLOC Installation Job 


Adding the Cataloged Procedure to Install 


You can use the L4PROC job from PLI.INSTALL to place the L4PROC cataloged 
procedure into PLILPROCLIB. The L4PROC procedure is used by LARECEIV 
and L4APPLY, which install the resident library. 


Before placing L4PROC in PLI.PROCLIB, you can customize it for your site’s 
needs by changing symbolic parameter defaults in the PROC statement of the 
procedure. You can identify, by comments in the job, the L4PROC JCL 
statements that are specific to SMP or SMP/E; use those statements which match 
your site’s version of SMP. The data set names in the target library DD statements 
must match the names you have selected for your site. 


If you decided to use system libraries as your target libraries, you must change the 
DSN portions of the corresponding DD statements to specify the appropriate 
system libraries. If you decided not to use multitasking, delete the DD statement 
for PLITASK. 
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You can obtain the L4PROC installation job by using the PUNCHJCL job shown 
in Figure 9. Just replace the data set member name in the SYSUT1 DD statement 
with the name ‘L4PROC’. 


Step 4: Installing the Distribution Tape 


When you have run the jobs to allocate the resident library data sets and add 
L4PROC to your procedure library, you are ready to install the distribution tape. 
You can use the L4RECEIV job from PLI.INSTALL to RECEIVE the OS PL/I 
Resident Library product and the L4APPLY job to apply it and the transient 
library. 


If you are using SMP to install, you can find more information about the 
RECEIVE and APPLY procedures in OS/VS SMP Programmer’s Guide. If you 
are using SMP/E to install, you can find more information about the RECEIVE 
and APPLY procedures in SMP/E User’s Guide and SMP/E Reference. You also 
have the option of using the interactive capability of SMP/E to install rather than 
the batch procedure described here. This is described in SMP/E Terminal User’s 
Guide. 


RECEIVEing the Resident Library 


Job L4RECEIV invokes L4PROC to RECEIVE resident library data sets from the 
distribution tape into temporary data sets allocated by SMP. If you installed 
L4PROC into private procedure library PLILPROCLIB, you must use the proper 
JES start procedure to enable you to use concatenated or alternate PROCLIBs, or 
insert L4PROC, ended by a // PEND statement, into L4RECEIV as an in-stream 
procedure. 


If you want to override some of L4PROC’s symbolic parameters, you can do so 
with the EXEC PROC statement you use in L4RECEIV to execute L4¢PROC. 


You must also verify the UNIT parameter in the SMPPTFIN DD statement. 
Several DD statements are provided and represent the possible combinations of 
resident library function and SMP level. These are identified by the comments 
accompanying them. You must select the group of input data that matches your 
resident library component(s) and your SMP product. Change the DDNAME on 
the single matching //SMPnnn DD * statement to SMPCNTL. The other DD 
statements in the job will have no effect. 


When you have finished modifying L4RECEIV according to your site’s needs, you 
can execute the L4RECEIV job. 
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APPLYing the Transient and Resident Libraries 


Note: 





If you are also installing the optimizing compiler using the individual product 
tape, do not run L4APPLY. Instead, turn now to Chapter 5, “Installing the 
Optimizing Compiler’ on page 39. If you are installing only the transient 


library and the resident library, continue with the remaining instructions in 
this chapter. 


Remember to adjust for using a private procedure library by using the appropriate 
JES start procedure or inserting L4PROC into L4APPLY. You can, if you wish, 
use the EXEC PROC statement in L4APPLY to override L4PROC’s symbolic 
parameters. L4APPLY provides several DD statements that represent the possible 
combinations of transient and resident library function and SMP level. You can 
identify these by the comments that accompany them. You must select the group 
of input data that matches your transient and resident library components and your 
SMP product. Change the DDNAME on the single matching //SMPnnn DD * 
statement to SMPCNTL. The other DD statements in L4APPLY will have no 
effect. 


When you have finished modifying L¢ APPLY according to your site’s needs, you 
can execute the L4APPLY job. 


Note: During the execution of L4APPLY, you will receive the following messages 
from the linkage editor: 


ITEWO461 SYMBOL PRINTED IS AN UNRESOLVED EXTERNAL REFERENCE 
IEWO342 ERROR - LIBRARY SPECIFIED DOES NOT CONTAIN MODULE 


IEW0461 is issued during the link-edit of some of the resident library modules. 
These unresolved references will later be resolved when a compiled application 
program is link-edited. 


IEW0342, which sets return code 08, is issued because SMP attempts to include, 
from the target library, members that do not yet exist. These messages are normal 
during initial installation. 


ACCEPTing the Transient and Resident Library 


You will probably want to try out your new transient and resident libraries for a 
while before you execute an SMP ACCEPT command to permanently install the 
product. You must, however, ACCEPT the product before you attempt to install 
any maintenance or USERMODs, as you will not be able to RESTORE the 
product to its previous level (in the event of a problem) if you have not previously 
executed the ACCEPT command against the product itself. 


You can easily modify L4APPLY to ACCEPT the product: 
e If you are using SMP, change the APPLY statement to ACCEPT. 


e If you are using SMP/E, change the APPLY statement to ACCEPT and 
change the target zone designation from PLITGT to PLIDLIB. 
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Completing Installation of CICS Support 


If you have chosen to install PL/I release 5.1’s support for CICS, there are some 
additional steps you must take after ACCEPTing your PL/I transient and resident 
libraries to connect their CICS components to the CICS product. These steps are 
described in Chapter 7, ‘Completing Installation of PL/I Support for CICS” on 
page 51. 


Customizing and Tuning Your OS PL/I Product 


You can customize your transient library product by changing the default values 
supplied by IBM for the execution-time options. Chapter 8, “Changing Option 
Defaults and Customizing PL/I” on page 55, describes the options and their 
IBM-supplied default values, and explains how to change the defaults according to 
the needs of your site. It also describes how to modify the PL/I-supplied error exit 
routine to issue and abend on abnormal termination of a PL/I program. 


You can also use the shared library, add transient library modules to the link pack 
area, and disable PL/I’s fast initialization facility if storage for PL/I program load 
modules is limited. These procedures are discussed in Chapter 9, “Postinstallation 
Tuning” on page 81. 
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Chapter 5. Installing the Optimizing Compiler 


This chapter describes the procedure for installing the OS PL/I Optimizing 
Compiler. If you are installing the individual compiler tape, you should read this 
entire chapter before attempting to perform any of the actions described here. If 
you are installing the composite tape that contains the compiler and the transient 
and resident libraries, you should use the procedures outlined in 

Chapter 2, “Installing the Composite Product” on page 13 to install the product. 


This chapter describes the contents of the distribution tape and gives the details of 
the following installation steps: 


1. Obtaining the JCL you need from the distribution tape 
2. Selecting your target libraries 
3. Establishing your site’s libraries 


4. Installing the compiler 


Note: 





You must run the transient library installation jobs through the LSRECEIV 
job and the resident library installation jobs through the L4RECEITV job 
before you begin installing the optimizing compiler. If you have previously 


installed the transient and resident libraries (that is, if you have run the 
L4APPLY job), and you now want to install the optimizing compiler, you 
must first reinstall the transient and resident libraries. 


Distribution Tape Contents 


The OS PL/I Optimizing Compiler is distributed on a standard labeled 9-track tape 
as product number 5734-PL1 or as part of the composite product number 
5734-PL3, which includes the Transient Library and the Resident Library. The 
Program Directory distributed with each product tape describes the files on the 
tape. 


The Optimizing Compiler distribution tape contains the following information: 


e SMP control statements and JCLIN 
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e« Selected compiler source modules, including the: 
— Installation JCL 
— Cataloged procedures to invoke the product 
— Compiler options modules 
— Macros used by the options modules 
— Sample program 
— HELP text for the optional TSO component 
e Compiler load modules 


¢ Compiler load modules for the optional TSO component 


Step 1: Obtaining the JCL You Need from the Distribution Tape 


The distribution tape provides JCL for installing the compiler. The job names and 
their descriptions follow: 


PIALLOC _ Allocates the distribution and target libraries. 
PIPROC Adds an SMP procedure to PLILPROCLIB. 
PIRECEIV _ Receives the optimizing compiler product components you choose. 


PIAPPLY Applies the transient and resident libraries and optimizing compiler 
product components you have chosen. 


PIMOD Changes compiler options defaults. 
The Program Directory distributed with the product tape includes listings of the 
installation jobs listed above. If you want to use any of the jobs, however, either as 


they are or with your own modifications, you must copy them to a data set to which 
you have access. 


Making Your Copy of the Installation JCL 


Figure 10 on page 41 shows a job that invokes the IEBCOPY utility program to 
copy the installation jobs from the distribution tape to the existing data set named 
PLLINSTALL, which you created during the installation of the transient library. 
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//P1GETJCL JOB MSGLEVEL=(1, 1) 

//GETJCL PROC FILENUM=,FMID= 

//TAP2DSK EXEC PGM=IEBCOPY 

//SYSPRINT DD SYSOUT=A 

//* 

//* NOTE: DSN, VOL, and LABEL parameters vary with each 

//* product release. Validate the DSN, VOL, and LABEL 

//* parameters of the following DD statement by referring 

//* to your Program Directory. 

//* 

//SYSUT1 DD DSN=&FMID. .F2, VOL=SER=APL51A, 
DISP=(SHR, PASS) , UNIT=tape, 
LABEL= ( &FILENUM, SL) 

//SYSUT2 DD DSN=PLI.INSTALL, DISP=OLD 

//SYSUT3 DD UNIT=SYSDA, SPACE=(TRK, (5,1)) 

//SYSUT4 DD UNIT=SYSDA,SPACE=(TRK, (5,1) ) 

//ENDGET PEND 

//* 

//* NOTE: FILENUM and FMID parameters vary with each 

//* product release. Validate the FILENUM and FMID 

//* parameters of the following EXEC statements by 

//* veferring to your Program Directory. 

//* 

/ /BASE EXEC GETJCL, FILENUM=3 , FMID=HPL1510 

COPY INDD=SYSUT1 , OUTDD=SYSUT2 
EXCLUDE MEMBER= (PLIXOPB) 
//TSO EXEC GETJCL, FILENUM=6, FMID=JPL1514 
COPY INDD=SYSUT1,OUTDD=SYSUT2 
SELECT MEMBER=(IELOAT) 
// 


Figure 10. Job to Copy Installation Jobs from Optimizing Compiler Tape 





When you have copied the installation jobs to your PLIINSTALL data set, you 
can print them for review or obtain copies that you can modify for use in later steps 
of the compiler installation process. Figure 11 shows a job that invokes the 
IEBPTPCH utility program to print all the jobs in the PLI.INSTALL data set. 





//LISTICL JOB MSGLEVEL=(1,1) 
//LISTALL EXEC PGM=IEBPTPCH 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD DSN=PLI.INSTALL,DISP=SHR 
//SYSUT2 DD SYSOUT=A 
PRINT TYPORG=PO,MAXFLDS=1 
RECORD FIELD=(80) 
// 


Figure 11. Job to Print All the Jobs in the PLIL.INSTALL Data Set 


In order to use one of the jobs in PLI.INSTALL, you must modify its JOB 
statement to meet your site’s requirements. You might also need to modify other 
parts of the jobs. Such modifications are described in the remainder of this 
chapter. 
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When your installation is complete and you have ACCEPTed your product, you 
can erase PLI.INSTALL. ACCEPT processing puts the installation jobs into the 
distribution library, PLI.PL141S. 


Step 2: Selecting Target Libraries 


You must choose either private or system libraries as target libraries into which you 
will install the optimizing compiler. (See “Preparing for Installation” on page 8 for 
more information about system and private libraries and how to choose a target 
library.) The following table shows the various libraries you can choose for the 
subcomponents of the compiler: 


Private Library _ | System library 


Optimizing compiler required PLI.PLICOMP | SYS1.LINKLIB 
load modules 

Optimizing compiler optional PLI.CMDLIB SYS1.CMDLIB 
TSO load modules 


Optimizing compiler optional PLI.HELP SYS1.HELP 
TSO HELP text 


Sample program PLI.SAMPLIB_ {| SYS1.SAMPLIB 


If you want to use an existing library but adequate space is not available, you can 
reallocate the existing library using the move/copy utility routine, IEHMOVE. 











Note: If you use an existing library, you must remember that, with release 5.1, 
SMP uses the DELETE operand of the ++VER control statement to replace the 
contents of the existing product data set. 


During the installation process, SMP will link-edit or copy load modules from the 
distribution tape into your target libraries. It will also copy product invocation 


cataloged procedures into the PROCLIB target library you selected during 
transient library installation. 


Step 3: Establishing Your Site’s Libraries 


The installation jobs you copied into your PLLINSTALL data set include all the 
jobs necessary to install the compiler. 


Allocating Compiler Data Sets 


You can use the PLALLOC job from PLI.INSTALL to allocate and catalog the OS 
PL/I Optimizing Compiler target libraries and distribution libraries. 


Space requirements for the compiler are specified in P1ALLOC in terms of blocks. 


You can use the space allocations as they are shown, or you can convert them to 
cylinder or track allocations according to the type of DASD device onto which you 
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will install the compiler. Accurate DASD space requirements for different device 
types are listed in the Program Directory in terms of tracks. 


Note: 





Before you run the job to allocate storage for the compiler, verify that the 
total amount of space needed is available on the DASD device you have 


chosen. 


You can obtain the P1ALLOC in-stream procedure using the job shown in 

Figure 12, then customize it for your site’s needs by changing symbolic parameter 
defaults in the PROC statement of the procedure or by overriding them in the 
EXEC statement that invokes the procedure. If you have chosen to use system 
libraries as your target libraries, you must delete the DD statements for the 
corresponding private libraries before executing PLALLOC. If you do not plan to 
use OS PL/I’s TSO component, you must delete the DD statements for CMDLIB 
and HELP. 


When you have finished modifying P1LALLOC according to your needs, you can 
execute PLALLOC. 





//PUNCHJCL JOB MSGLEVEL=(1, 1) 
//PUNCHIT EXEC PGM=IEBGENER 


//SYSIN DD DUMMY 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD DSN=PLI.INSTALL(P1ALLOC) , DISP=SHR 


//SYSUT2 DD SYSOUT=B,DCB=(RECFM=F, LRECL=80 , BLKSIZE=80) 


Figure 12. Job to Obtain PIALLOC Installation Job 


Adding the Cataloged Procedure to Install 


You can use the PIPROC job from PLI.INSTALL to place the PIPROC cataloged 
procedure into PLILPROCLIB. The P1PROC procedure is used by PLIRECEIV 
and P1APPLY, which install the compiler, and also by P1MOD if you decide to 
change the IBM-supplied compiler option defaults. 


Before placing P1PROC into PLI.LPROCLIB, you can customize it for your site’s 
needs by changing symbolic parameter defaults in the PROC statement of the 
P1PROC procedure. You can identify, by comments in the P1PROC job, the JCL 
statements that are specific to SMP or SMP/E; use those statements that match 
your site’s version of SMP. 


The data set names in the target library DD statements must match the names you 
have selected for your site. If you decided to use system libraries as your target 
libraries, you must change the DSN portions of the corresponding DD statements 
to specify the appropriate system libraries. 
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If you decided not to use the multitasking component, delete the PLITASK DD 
statement. If you decided not to use the TSO component, delete the CMDLIB and 
HELP DD statements. 


You can obtain the P1PROC installation job by using the PUNCHJCL job shown 
in Figure 12 on page 43. Replace the data set member name in the SYSUT1 DD 
statement with the name ‘P1PROC’. 


Step 4: Installing the Distribution Tape 


When you have run the jobs to allocate the compiler data sets and add PIPROC to 
your procedure library, you are ready to install the distribution tape. You can use 
the PLRECEIV member of PLI.IINSTALL to RECEIVE the OS PL/I Optimizing 
Compiler product, and the P1LAPPLY member to APPLY it and the libraries. 


If you are using SMP to install, you can find more information about the 
RECEIVE and APPLY procedures in OS/VS SMP Programmer’s Guide. If you 
are using SMP/E to install, you can find more information about the RECEIVE 
and APPLY procedures in SMP/E User’s Guide, and SMP/E Reference. You also 
have the option of using the interactive capability of SMP/E to install rather than 
the batch procedure described here. This is described in SMP/E Terminal User’s 
Guide. 


RECEIVEing the Optimizing Compiler 


Job P1IRECEIV invokes P1PROC to RECEIVE compiler data sets from the 
distribution tape into temporary data sets allocated by SMP. If you installed 
P1PROC into private procedure library PLILPROCLIB, you must use the proper 
JES start procedure to enable you to use concatenated or alternate PROCLIBs, or 
insert P1PROC, ended by a // PEND statement, into PLIRECEIV as an in-stream 
procedure. 


If you want to override some of P1PROC’s symbolic parameters, you can do so 
with the EXEC PROC statement you use in PIRECEIV to execute P1PROC. 


You must also verify the UNIT parameter in the SMPPTFIN DD statement. 
Several DD statements are provided and represent the possible combinations of 
compiler components and SMP level. These are identified by the comments 
accompanying them. You must select the group of input data that matches your 
compiler components and your SMP product. Change the DDNAME on the single 
matching //SMPnnn DD * statement to SMPCNTL. 


When you have finished modifying P1!RECEIV according to your site’s needs, you 
can execute the PLRECEIV job. 
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APPLYing the Transient and Resident Libraries and the Compiler 


Remember to adjust for using a private procedure library by using the appropriate 
JES start procedure or inserting P1PROC into PIAPPLY. You can, if you wish, 
use the EXEC PROC statement in P1APPLY to override P1PROC’s symbolic 
parameters. 


P1APPLY provides several DD statements that represent the possible 
combinations of transient and resident library and optimizing compiler function and 
SMP level. You can identify these by the comments that accompany them. You 
must select the group of input data that matches your transient and resident library 
and optimizing compiler components and your SMP product. Change the 
DDNAME on the single matching //SMPnnn DD * statement to SMPCNTL. The 
other DD statements in PI1APPLY will have no effect. 


When you have finished modifying P1APPLY according to your site’s needs, you 
can execute PIAPPLY. 


Note: During the execution of P1APPLY, you will receive the following messages 
from the linkage editor: 


IEWO461 SYMBOL PRINTED IS AN UNRESOLVED EXTERNAL REFERENCE 
IEWO342 ERROR - LIBRARY SPECIFIED DOES NOT CONTAIN MODULE 


IEW0461 is issued during the link-edit of compiler module IELOPA. You should 
ignore the unresolved external reference to TEAXPALL because this module is not 
used in either an MVS or MVS/XA environment. 


IEW0461 is also issued during the link-edit of some of the resident library modules. 
These references will later be resolved when a compiled application program is 
link-edited. 


IEW0342, which sets return code 08, is issued because SMP attempts to include, 
from the target library, members which do not yet exist. These messages are 
normal during initial installation. 


Verifying Correct Installation 


After P1APPLY has executed correctly, the PL/I transient library, resident library, 
and optimizing compiler are ready for use. You will probably want to run the 
sample program to test the success of the installation process. See 

Chapter 6, ‘‘Running the Installation Verification Program” on page 47. 


ACCEPTing the Compiler 


You will probably want to try out your new compiler and libraries for a while 
before you execute an SMP ACCEPT command to permanently install the product. 
You must, however, ACCEPT the product before you attempt to install any 
maintenance or USERMODs, as you will not be able to RESTORE the product to 
its previous level (in the event of a problem) if you have not previously executed 
the ACCEPT command against the product itself. 
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You can easily modify PLAPPLY to ACCEPT the product: 
¢ If you are using SMP, change the APPLY statement to ACCEPT 


e If you are using SMP/E, change the APPLY statement to ACCEPT and 
change the target zone designation from PLITGT to PLIDLIB 


Completing Installation of CICS Support 


If you have chosen to install PL/I release 5.1’s support for CICS, there are some 
additional steps you must take after ACCEPTing your PL/I products to connect 
the transient and resident library CICS components to the CICS product. These 
steps are described in Chapter 7, ‘Completing Installation of PL/I Support for 
CICS” on page 51. 


Customizing and Tuning Your OS PL/I Product 


You can customize your PL/I product by changing the default values supplied by 
IBM for the execution-time and compiler options. You can also modify the PL/I 
error exit routine to issue an abend on abnormal termination of a PL/I program. 
Chapter 8, “Changing Option Defaults and Customizing PL/I’’ on page 55, 
describes the options and their IBM-supplied default values, and explains how to 
change the defaults according to the needs of your site. It also describes how to 
modify the error exit routine. 


You can also use the shared library, add transient library modules to the link pack 
area, and disable PL/I’s fast initialization facility if storage for PL/I program load 
modules is limited. These procedures are discussed in Chapter 9, ‘‘Postinstallation 
Tuning” on page 81. 
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Chapter 6. Running the Installation Verification Program 


The sample program provided on the distribution tape enables you to verify the 
success of your installation by exercising several of the features of the OS PL/I 
libraries and compiler. It illustrates the use of the compile-time preprocessor to 
convert source programs written for the PL/I (F) Compiler to a form appropriate 
for compilation by the OS PL/I Optimizing Compiler. 


You can find a listing of the compilation and execution of the sample program in 
OS PL/I Optimizing Compiler Programmer’s Guide. 


Printing the Sample Program 


Figure 13 shows a job that invokes the IEBPTPCH utility program to print the 
sample program you installed into the PLISAMPLIB data set during SMP APPLY 
processing. If you chose SYS1.SAMPLIB instead of the private library, change the 
data set name in the SYSUT1 DD statement accordingly. 


//LISTSAMP JOB MSGLEVEL=(1,1) 
//LISTALL EXEC PGM=IEBPTPCH 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD DSN=PLI.SAMPLIB, DISP=SHR 
//SYSUT2 DD SYSOUT=A 
PRINT TYPORG=PO,MAXNAME=1,MAXFLDS=1 
MEMBER NAME=PLIXSMPB 
RECORD FIELD=(80) 
// 


Figure 13. Job to Print the Sample Program 


Compiling, Link-Editing, and Executing the Sample Program 


Figure 14 gives an example of JCL you can use to compile, link-edit, and execute 
the sample program from system libraries. 


//SAMPLEPL JOB MSGLEVEL=(1, 1) 
//EXEC EXEC PROC=PLIXCLG 
//PLI.SYSIN DD DSN=SYS1.SAMPLIB(PLIXSMPB) , DISP=SHR 


Figure 14. Example of Job to Run the Sample Program 
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If you have installed PL/I into private libraries, you must modify the IBM-supplied 
product invocation cataloged procedures. Figure 15 on page 48 shows a job 
coded to run the sample program from private libraries using an in-stream PL/I 
procedure. PLIXCLG is one of the product invocation cataloged procedures 
provided on the distribution tape. As described in ‘Using Private Libraries’’ on 
page 9, it has been modified on the lines marked with <===NOTE to use private 
rather than system libraries to compile, link-edit, and execute PL/I. 


//SAMPLEPL JOB MSGLEVEL=(1, 1) 
//PLIXCLG PROC LKLBDSN='PLI.PLIBASE' <===NOTE 
//PLI EXEC PGM=IELOAA, PARM='OBJECT,NODECK' , REGION=128K 
//STEPLIB DD DSN=PLI.PLICOMP,DISP=SHR ===NOTE 
//SYSPRINT DD SYSOUT=A 
//SYSLIN DD DSN=&&LOADSET, DISP=(MOD, PASS) , UNIT=SYSSQ, 
SPACE= (80, (250, 100) ) 
//SYSUT1 DD DSN=&&SYSUT1,UNIT=SYSDA, 
SPACE= (1024, (200,50) ,, CONTIG, ROUND) , DCB=BLKSIZE=1024 
//LKED EXEC PGM=IEWL, PARM='XREF,LIST‘ , COND=(9,LT,PLI) , REGION=256K 
//SYSLIB DD DSN=&LKLBDSN,DISP=SHR 
// DD DSN=PLI.PLIBASE, DISP=SHR <===NOTE 
//SYSLMOD DD DSN=&&GOSET(GO) ,DISP=(MOD,PASS) ,UNIT=SYSDA, 
SPACE= (1024, (50,20,1)) 
//SYSUT1 DD DSN=&ESYSUT1,UNIT=SYSDA, SPACE=(1024, (200,20)), 
DCB=BLKSIZE=1024 
//SYSPRINT DD SYSOUT=A 
//SYSLIN DD DSN=&§&LOADSET, DISP= (OLD, DELETE) 
DD DDNAME=SYSIN 
//SYSIN DD DUMMY 
//GO EXEC PGM=*.LKED.SYSLMOD, COND=((9,LT,PLI),(9,LT,LKED)), 
REGION=100K 
//STEPLIB DD DSN=PLI.PLILINK, DISP=SHR <===NOTE 
//SYSPRINT DD SYSOUT=A 
//ENDPLIX PEND 
/ EXEC EXEC PROC=PLIXCLG 
//PLI.SYSIN DD DSN=PLI.SAMPLIB(PLIXSMPB) , DISP=SHR <===NOTE 
// 


Figure 15. Job to Run Sample Program from Private Libraries 





Interpreting Messages Generated by the Sample Program 


During preprocessing and compilation of the sample program, some diagnostic 
messages are generated. The preprocessor generates warning (W) level messages. 
The compiler generates error (E), warning (W), and informational (I) messages. 
One of these is: 


IELO413I E DECLARATION OF ‘A‘' IGNORED 


IEL0413] E, which sets compiler return code 08, is normal for the compilation of 
the sample program and will not affect execution. 


The execution of the sample program sets return code 0101. This return code is 
also normal. 
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ACCEPTing Your PL/I Product 


After you have run the sample program and verified that your PL/I product is 
installed correctly, you should ACCEPT the product. It is especially important to 
ACCEPT the product before you change any of the IBM-supplied option defaults. 


If you installed the composite product 5734-PL3, return to “ACCEPTing the OS 
PL/I Product” on page 21. 


If you installed the individual products 5734-LMS, 5734-LM4, and 5734-PL1, 
return to ‘“ACCEPTing the Compiler” on page 45. 
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Chapter 7. Completing Installation of PL/I Support for CICS 


If you have installed the optional CICS component of the OS PL/I release 5.1 
transient library or of the OS PL/I release 5.1 transient and resident libraries, you 
must take some additional steps to ensure that CICS can communicate with your 
new release of PL/I. 


First, after ACCEPTing your PL/I product, you must add PL/I entries to the 
processing program table (PPT) and the destination control table (DCT). Then 
you must add PL/I CICS data sets to the CICS startup job stream. This chapter 
describes these procedures. 


Adding PPT Entries 


The PPT entries listed in the DFHPPT macro statements below are part of the 
transient library CICS support installed into PLISAMPLIB as member PLTCICS 
during transient library installation. 


PL/I support for CICS requires that these entries be added to the CICS processing 
program table so that they are included when your CICS system is generated. 


The PPT macro instructions are: 


DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 
DFHPPT 


TYPE=ENTRY , PROGRAM=IBMBCCLA 
TYPE=ENTRY , PROGRAM=IBMBCCRA 
TYPE=ENTRY , PROGRAM=IBMBEOCA 
TYPE=ENTRY , PROGRAM=IBMBETAA 
TYPE=ENTRY , PROGRAM=IBMBETBA 
TYPE=ENTRY , PROGRAM=IBMBETCA 
TYPE=ENTRY , PROGRAM=IBMBETIA 
TYPE=ENTRY , PROGRAM=IBMBETOA 
TYPE=ENTRY , PROGRAM=IBMBETPA 
TYPE=ENTRY , PROGRAM=IBMBETQA 
TYPE=ENTRY , PROGRAM=IBMBETTA 
TYPE=ENTRY , PROGRAM=IBMFEFCA 
TYPE=ENTRY , PROGRAM=IBMFESMA 
TYPE=ENTRY , PROGRAM=IBMFESNA 
TYPE=ENTRY , PROGRAM=IBMFKCSA 
TYPE=ENTRY , PROGRAM=IBMFKMRA 
TYPE=ENTRY , PROGRAM=IBMFKPTA 
TYPE=ENTRY , PROGRAM=IBMFKTBA 
TYPE=ENTRY , PROGRAM=IBMFKTCA 
TYPE=ENTRY , PROGRAM=IBMFKTRA 
TYPE=ENTRY , PROGRAM=IBMFPGDA 
TYPE=ENTRY , PROGRAM=IBMFPMRA 
TYPE=ENTRY , PROGRAM=IBMFSTVA 
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Adding DCT Entries 


DCT entries are required for queues CPLI and CPLD. CPLI is the queue to which 
stream output is transmitted, and CPLD is the queue to which PLIDUMPs are sent. 
These queues may be intrapartition, extrapartition, or indirect. If extrapartition 
destinations are used, they must be V-format with an LRECL of at least 133 for 
CPLI and 125 for CPLD. 


You use the macro DFHDCT to define the entries for CPLI and CPLD and to 
define the PLIMSG buffer, which receives the output from the two queues, as 
shown in the following example: 





PLIMSG DFHDCT TYPE=SDSCI, PL/I OPTIMIZER MESSAGES 
BLKSIZE=137, 
BUFNO=1, 
DSCNAME=PLIMSG, 
RECSIZE=133, 
RECFORM=VARUNB, 
TYPEFLE=OUTPUT 


PS PG OS OM OS PS 


CPLI DFHDCT TYPE=EXTRA, PL/I SYSPRINT OUTPUT 
DESTID=CPLI, 
DSCNAME=PLIMSG 


mS OS 


CPLD DFHDCT TYPE=INDIRECT, PL/I DUMPS X 
DESTID=CPLD, X 
INDDEST=CPLI 


When DFHDCT encounters the above entry names, it will generate warning 
messages that state that queues beginning with ’C’ are reserved for CICS. These 
messages are normal; you can ignore them. 


Adding PL/I CICS Data Sets to the CICS startup job stream 


Before you can run any CICS transactions, you must start CICS in the CICS 
region. CICS/OS/VS Version 1 Release 6 Modification 1: Installation and 
Operations Guide describes the CICS system startup procedure and gives an 
example of a CICS startup job stream. 


In order to add PL/I’s CICS component to CICS, you must concatenate PL/I’s 
CICS data sets after the CICS161.LOADLIB2 and CICS161.LOADLIB data sets 
in the DFHRPL DD statement in the startup job stream. There are several things 
you must be aware of when you do this: 


1. The PL/I data sets in this concatenation must have the same name you 
assigned to the PL/I transient library CICS components you just installed (for 
example, PLI.LPLILINK). 


2. No data set concatenated before PLI.PLILINK (or the transient library CICS 


component name you chose) may contain any module IBMxxxxx, DFHSAP, or 
DFHPL10I. 


52 OS PL/I Installation Guide for MVS 


3. If you have chosen to place your transient library CICS component into 
SYS1.LINKLIB instead of PLI.PLILINK, no modules named in item 2 above 
may occur in any data set in the DFHRPL concatenation. 


After you have added your PL/I CICS data sets to the CICS startup job stream, 
your PL/I support for CICS is ready to use. 


Chapter 7. Completing Installation of PL/I Support for CICS 53 


Chapter 8. Changing Option Defaults and Customizing PL/I 


After you have ACCEPTed the OS PL/I product(s) you have chosen to install, 
there are some additional steps you can take to adapt PL/I to your site’s specific 
needs. You can change the IBM-supplied execution-time and/or compiler option 
defaults, and you can modify the IBM-supplied error exit routine. 


Execution-time option defaults are those values assumed if the application 
programmer does not supply overriding values in JCL at the time of execution of a 
PL/I program. Compiler option defaults are those values assumed if the 
application programmer does not supply overriding values in JCL and/or in 
*PROCESS statements at the time of compilation of a PL/I program. 


The error exit routine IBMBEER, as supplied by IBM, does not cause an abend to 
occur. You can modify the routine so that an abnormal termination of a PL/I 
program causes an abend. 

This chapter contains the information you need to change the execution-time and 
compiler option defaults and to modify the IBMBEER module. It includes the 
following information: 


e A table listing the execution-time options and the default values assigned to 
them by IBM. 


e Descriptions of the execution-time options and all their possible values. 


e Discussion of how to code your changes to the execution-time options macro 
PLTRLIB in source module IBMBXOPT. 


« A table listing the compiler options for both batch and conversational modes, 
and the default values assigned to them by IBM. 


¢« Descriptions of the compiler options and all their possible values. 
e Discussion of how to code your changes to the compiler options macros 
PLEIXOPB and PLIXOPC in source modules IELOAS and IELOAT, 


respectively. 


e Discussion of how the BMBEER module works and an example of how you 
might modify it. 
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Changing Execution-Time Option Defaults 


The execution-time options and the IBM-supplied defaults provided on the 
transient library or composite distribution tape are shown in Figure 16. If these 
values satisfy the needs of your system, you do not need to do anything more. 


IBM—Supplied Defaults 








For Nontasking For Tasking 
Option Environment Environment 









HEAP 



















Initial allocation 0 0 
Incremental value kK 4K 
Location ANYWHERE ANYWHERE 
HEAP area disposition KEEP KEEP 
ISAINC (ISA increment) 0 
Subtask ISA increment N/A 
1SAS1ZE 0 8192 
Subtask ISA size N/A 8192 
Subtask maximum number N/A 20 





REPORT/NOREPORT NOREPORT NOREPORT 


TASKHEAP 



















Initial allocation 0 
Incremental value 4K 
Location ANYWHERE 
TASKHEAP area disposition KEEP 


Figure 16. IBM-Supplied Transient Library Execution-Time Option Default Values 


If, however, you prefer different default values, you can change the execution-time 
option defaults immediately after installing and ACCEPTing the product, or you 
can run with the IBM-supplied option defaults for a while to see if they meet the 
needs of your site, and change the defaults at some future time. For more detailed 
information on these options, see “Description of PLTRLIB Operands” on 

page 57 and OS PL/I Optimizing Compiler: Programmer’s Guide. 


Note: 





You change the execution-time option defaults by RECEIVEing and 
APPLYing an SMP USERMOD. You can install the USERMOD after you 
have either APPLYed or ACCEPTed the PL/I product, but we recommend 


that you wait until after you have ACCEPTed the product, for the following 
reason: if you have not ACCEPTed the product, you will not be able to remove 
the USERMOD using the SMP RESTORE command. 
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Specifying Execution-Time Option Defaults 


To change the IBM-supplied execution-time option defaults, you must create an 
SMP USERMOD to modify the PLTRLIB macro statement in the transient library 
source module IBMBXOPT. This USERMOD uses the IEBUPDTE utility 
program to replace numbered statements in the IBMBXOPT source module with 
equal numbered statements from your USERMOD, so you must be sure to match 
exactly the sequence numbers (columns 73 through 80) in your USERMOD to 
those of the statements in the IBMBXOPT source module they are to replace. 


The PLI.INSTALL data set on your distribution tape includes a member that 
contains a sample USERMOD designed to change the HEAP execution-time 
option default values for both nontasking and multitasking environments. If you 
installed the transient library distribution tape, the sample USERMOD is in 
PLIINSTALL’s member LSMOD. If you installed the composite tape, the sample 
USERMOD is in member P3MOD. 


The following sections describe how to adapt LSMOD or P3MOD to your site’s 
needs. 


Description of PLTRLIB Operands 
The operands of the PLTRLIB macro statement in the IBMBXOPT ASSEMBLE 


file define the defaults for the execution-time options. Figure 17 on page 58 gives 
an example of how the PLTRLIB macro statement is coded. 


Chapter 8. Changing Option Defaults and Customizing PL/I 57 





Macro 


PLTRLIB 


END 


Notes: 


Operands (IBM-supplied defaults) 


NONTASK= (ISASIZE=0, 


NOREPORT, 
SPIE, 
STAE, 


HEAP=(0,4K,ANYWHERE, KEEP) , 
ISAINC=(0)), 


IBMBXOPT 


TASK= (ISASIZE=(8192,8192,20), 


NOREPORT, 
SPIE, 
STAE, 


HEAP=(0,4K,ANYWHERE, KEEP) , 


TASKHEAP= (0,4K,ANYWHERE, KEEP) , 


ISAINC=(0,0)), 


ARCH=XA 


Sequence 

BEGIN NONTASK PART DEFAULT xX10000000 
DEFAULT X16000000 

DEFAULT X22000000 

DEFAULT X29000000 

DEFAULT X36000000 

END OF NONTASK LIST DEFAULT X43000000 
DEFAULT X50000000 

DEFAULT X57000000 

DEFAULT X64000000 

DEFAULT X¥71000000 

DEFAULT X78000000 

DEFAULT X85000000 

DEFAULT X92000000 

DEFAULT 95000000 

99999999 


1. The actual macro coded in the IBMBXOPT ASSEMBLE source module on your distribution tape might have 
changed since this book was written, so you must look at that module for sequence numbers before you attempt 
to make changes to the macro with your USERMOD. 


2. If you want to change option defaults, you should be aware that ARCH=XA will work on any system, XA or 
not, so long as you are using Assembler H, Version 2 or later. (See page 64 for more information on the 
ARCH option.) If you are not using Assembler H, Version 2 or later, you must specify ARCH=STD in your 
USERMOD, or you will get an assembler error. 


Figure 17. Example of PLTRLIB Macro in IBMBXOPT Source Module 





Coding Conventions 


The coding conventions used in the example in Figure 17 and in the PLTRLIB 
macro on your distribution tape are as follows: 


e Operands are separated by commas. 


e Uppercase letters, numbers, and punctuation marks must be coded exactly as 
shown. 


e Brackets [] must never be coded. 


e Lowercase letters and words represent variables for which you must substitute 
specific information. 


e Items or groups of items within brackets [] are optional. They may be omitted 
at your discretion. 


If you are satisfied with the IBM-supplied defaults, leave the macro as it is. If, 
however, you want to change an option’s default value, you must specify its 
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Operand Descriptions 


corresponding PLTRLIB operand in your USERMOD. “Coding Your Changes to 
the PLTRLIB Macro” on page 65 explains how to code your USERMOD to 
change those values you need to change. 


The following section describes the operands of the PLTRLIB macro. Each 
operand except the last, ARCH, corresponds to an execution-time option. The list 
will help you determine which option values are most useful for your site’s needs 
and whether you must change some of the IBM-supplied defaults to meet those 
needs. 


NONTASK=({HEAP=(size,increment, ANYWHERE | BELOW,KEEP | FREE)] 
[ ISAINC=size] 
[ ISASIZE=size] 
[REPORT | NOREPORT] 
[, SPIE | NOSPIE] 
[,STAE | NOSTAE]) 
specifies the options for tasks that are not multitasking. 





HEAP=(size,increment, ANYWHERE | BELOW,KEEP | FREE) 
isolates storage for allocated (that is, CONTROLLED and 
dynamically allocated BASED) variables from all other PL/I storage 
and specifies how that storage is to be handled. 


size 
optional. If specified, it determines the minimum initial size of 
HEAP storage, and is specified in bytes or as nnnK or as nnM. 
If not specified, no HEAP area is used. The IBM-supplied 
default is HEAP=0, that is, the HEAP option is not in effect. 


increment 
optional. If specified, it determines the minimum size of any 
subsequent increment to the HEAP area. The IBM-supplied 
default value for the HEAP increment is 4K. 


ANYWHERE 
specifies that PL/I can allocate the HEAP area anywhere in 
storage. In an MVS/XA environment, this allows PL/I to 
allocate HEAP storage either above or below 16 megabytes; 
PL/I will usually place it above 16 megabytes. In a non-XA 
environment, use of ANYWHERE necessarily places HEAP 
storage below 16 megabytes. This is the IBM-supplied default. 


BELOW 
specifies that PL/I must allocate HEAP storage below 16 
megabytes, in storage accessible to 24-bit addressing. 


KEEP 
specifies that storage allocated to a HEAP increment will not be 
released when a FREE statement in the program deallocates the 
last variable stored there. This is the IBM-supplied default. 
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FREE 
specifies that storage allocated to a HEAP increment will be 
released when the variable occupying it is FREEd. 


ISAINC=size 
specifies the minimum size of an increment to the ISA. 


If ISAINC is not specified, when the storage currently allocated to the 
ISA is not large enough to handle all of a program’s storage requests, 
only that amount of storage needed at the time of the request is 
obtained. When ISAINC is used, the amount of storage allocated 
when the ISA is too small for the current request is the /arger of the 
ISAINC size or the requested size. Thus the use of the ISAINC 
option can save the increased execution time caused by frequent 
GETMAINSs of small amounts of storage. 


size 
specifies the minimum amount by which the ISA will be 
incremented, and is specified in bytes or as nnnK or nnM. The 
IBM-supplied default is ISAINC=0. 
ISASIZE=size 


specifies the length of the initial storage area. 


size 
specified in bytes or as nnnK or nnM. It can be preceded by a 
minus sign. The storage will be contiguous. 


A size of ‘0’ causes PL/I to issue a GETMAIN request for the 
largest block of contiguous storage in the region; PL/I then 
returns half of that block to the system and retains the other 
half as its ISA. 


The minus sign is used when stating the amount of storage in 
the partition that must be left outside the resident load module 
and the ISA. A value of ‘-0’ should not be specified unless the 
largest possible ISA is required and no files, including 
SYSPRINT, will be used. Otherwise, an ABEND might occur 
because of lack of system storage. 


For CICS: This is the size of the initial work space obtained. If 0 or 
-0 is specified, either by the programmer or because it is the default, a 
size is calculated, and a GETMAIN is issued, at execution time. This 
size is always the PMA (program management area) size plus the main 
procedure’s DSA (dynamic storage area) size. 


The IBM-supplied default for ISASIZE in a nontasking environment is 
ISASIZE=0. 


REPORT 
specifies that a program management report is required. 
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NOREPORT 
specifies that no program management report is required. This is the 
IBM-supplied default. 


SPIE 
specifies that, if a program interrupt occurs, the PL/I error handler is 
to be used. Under certain circumstances the ERROR condition will be 
raised. This is the IBM-supplied default. 


For CICS: This subparameter is ignored. 


NOSPIE 
specifies that, on program initialization, PL/I will not issue the SPIE 
or ESPIE macro to request control after a program check. Unless 
running under MVS/XA, do not use NOSPIE when extended 
precision variables are used in the PL/I source program. 


For CICS: This subparameter is ignored. 


STAE 
specifies that, if an abend occurs, the PL/I library routines are to 
attempt to raise the ERROR condition or to produce a diagnostic 
message and a PLIDUMP. This is the IBM-supplied default. 


For CICS: This specifies that transaction abends will be handled by 
the PL/I error handler. EXEC CICS HANDLE ABEND command 
will be issued by PL/I. 


NOSTAE 
specifies that, on program initialization, PL/I will not issue the STAE 
or ESTAE macro to request control after an abend. 


For CICS: This specifies that transaction abends will not be handled 
by the PL/I error handler. 


TASK=({HEAP=(size,increment, ANY WHERE | BELOW,KEEP | FREE)] 
[ ISAINC=(sizel ,size2)] 
[ ISASIZE=(sizel ,size2,tasks)] 
[,REPORT | NOREPORT] 
[, SPIE | NOSPIE] 
[,STAE | NOSTAE] 
[,TASKHEAP=(size,increment, ANYWHERE | BELOW,KEEP | FREE))) 
specifies the options for use in a multitasking environment. 





HEAP =(size, increment, ANYWHERE | BELOW,KEEP | FREE) 
isolates storage for allocated (that is, CONTROLLED and 
dynamically allocated BASED) variables from all other PL/I storage 
and specifies how that storage is to be handled. In a multitasking 
environment, HEAP option values apply to the major task, only; 
subtask allocated storage is governed by the TASKHEAP option. 





size 
is optional. If specified, it determines the minimum initial size 
of HEAP storage, and is specified in bytes or as nnnK or as 
nnM. If not specified, no HEAP area is used. The 
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IBM-supplied default is HEAP=0, that is, the HEAP option is 
not in effect. 


increment 
is optional. If specified, it determines the minimum size of any 
subsequent increment to the HEAP area. The IBM-supplied 
default value for the HEAP increment is 4K. 


ANYWHERE 
specifies that PL/I can allocate the HEAP area anywhere in 
storage. In an MVS/XA environment, this allows PL/I to 
locate HEAP storage either above or below 16 megabytes; PL/I 
will usually place it above 16 megabytes. In a non-XA 
environment, use of ANYWHERE necessarily places HEAP 
storage below 16 megabytes. This is the IBM-supplied default. 


BELOW 
specifies that PL/I must allocate HEAP storage below 16 
megabytes, in storage accessible to 24-bit addressing. 


KEEP 
specifies that storage allocated to a HEAP increment will not be 
released when a FREE statement in the program deallocates the 
last variable stored there. This is the IBM-supplied default. 


FREE 
specifies that storage allocated to a HEAP increment will be 
released when the variable occupying it is FREEd. 


ISAINC =(sizel ,size2) 
specifies the minimum size of an increment to the ISA. 


If ISAINC is not specified, when the storage currently allocated to the 
ISA is not large enough to handle all of a program’s storage requests, 
only that amount of storage needed at the time of the request is 
obtained. When ISAINC is used, the amount of storage allocated 
when the ISA is too small for the current request is the /arger of the 
ISAINC size or the requested size. Thus the use of the ISAINC 
option can save the increased execution time caused by frequent 
GETMAINSs of small amounts of storage. 


sizel 
specifies the minimum amount by which the ISA for the major 
task will be incremented, and is specified in bytes or as nnnK or 
nnM. The IBM-supplied default is ISAINC=0. 


size2 
specifies the minimum amount by which the ISA for any subtask 
will be incremented, and is specified in bytes or as nnnK or 
nnM. 


ISASIZE=(size1,size2,tasks) 
specifies the storage sizes and number of subtasks. 
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sizel 
specifies the length of the initial storage area. 


This specifies the main task size, in bytes or as nnnK or as nnM. 
It can be preceded by a minus sign. The storage will be 
contiguous. 


A size of ‘0’ causes PL/I to issue a GETMAIN request for the 
largest block of contiguous storage in the region; PL/I then 
returns half of that block to the system and retains the other 
half as its ISA. 


The minus sign is used when stating the amount of storage in 
the partition that must be left outside the resident load module 
and the ISA. This storage will be contiguous. A value of ‘-0’ 
should not be specified unless the largest possible ISA is 
required and no files, including SYSPRINT, will be used. 
Otherwise, an ABEND might occur because of lack of system 
storage. 


The IBM-supplied default is 8192 bytes. 


size2 
specifies the length of each subtask initial storage area. This is 
an unsigned integer specified in bytes or as nnnK or nnM. 


The IBM-supplied default is 8192 bytes. 


tasks 
is a decimal integer that is the maximum number of subtasks. 
The IBM-supplied default is 20. 


REPORT 
specifies that a program management report is to be generated. 


NOREPORT 
specifies that no program management report is to be generated. This 
is the IBM-supplied default. 


SPIE 
specifies that, if a program interrupt occurs, the PL/I error handler is 
to be used. Under certain circumstances, the ERROR condition will 
be raised. This is the IBM-supplied default. 


NOSPIE 
specifies that, on program initialization, PL/I will not issue the SPIE 
or ESPIE macro to request control after a program check. Unless 
running under MVS/XA, do not use NOSPIE when extended 
precision variables are used in the PL/I source program. 


STAE 
specifies that, if an abend occurs, the PL/I library routines are to 
attempt to raise the ERROR condition or to produce a diagnostic 
message and a PLIDUMP. This is the IBM-supplied default. 
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NOSTAE 


specifies that, on program initialization, PL/I will not issue the STAE 
or ESTAE macro to request control after an abend. 


TASKHEAP=(size,increment, ANYWHERE | BELOW,KEEP | FREE) 





specifies that a separate heap storage area is to be created for each 
subtask in a multitasking environment. This separates storage for 
CONTROLLED and dynamically allocated BASED variables in a 
subtask from all other PL/I storage and specifies how that storage is 
to be handled. 


size 
is optional. If specified, it determines the minimum initial size 
of TASKHEAP storage, and is specified in bytes or as nnnK or 
as nnM. If not specified, no TASKHEAP area is used. The 
IBM-supplied default is TASKHEAP=0, that is, the 
TASKHEAP option is not in effect. 


increment 
is optional. If specified, it determines the minimum size of any 
subsequent increment to the TASKHEAP areas. The 
IBM-supplied default value for the TASKHEAP increment is 
4K. 


ANYWHERE 
specifies that PL/I can allocate the TASKHEAP areas 
anywhere in storage. In an MVS/XA environment, this allows 
PL/I to locate TASKHEAP storage either above or below 16 
megabytes; PL/I will usually place it above 16 megabytes. Ina 
non-XA environment, use of ANYWHERE necessarily places 
TASKHEAP storage below 16 megabytes. This is the 
IBM-supplied default. 


BELOW 
specifies that PL/I must allocate TASKHEAP storage below 16 
megabytes, in storage accessible to 24-bit addressing. 


KEEP 
specifies that storage allocated to a TASKHEAP increment will 
not be released when a FREE statement in the program 
deallocates a variable stored there. This is the IBM-supplied 
default. 


FREE 
specifies that storage allocated to a TASKHEAP increment will 
be released when the variable occupying it is FREEd. 


ARCH=STD | XA 
specifies whether the transient library will be used on an MVS or an 
MVS/XA system. 


STD 
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specifies that the transient library will be used on an MVS (non-XA) 
system. 


specifies that the transient library will be used on an MVS/XA 
system. This is the IBM-supplied default. 


If you do not change any execution-time option defaults with a 
USERMOD, the ARCH=XA default will cause the PL/I load 
modules to have the appropriate AMODE and RMODE values for the 
system on which they are installed, whether it is an XA or a non-XA 
system. You must, however, make changes to the LSALSMPn job, 
which allocates SMP data sets, in order to make use of the 
ARCH=XA specification. See the comments in the LSALSMPn job 
you are using. 


If you code a USERMOD to change option defaults, you may leave 
the ARCH=XA specification as it is if you are using Assembler H 
Version 2 or later, but you must change ARCH=XA to ARCH=STD 
if you are not using Assembler H Version 2 or later. ARCH=XA 
specifies AMODE and RMODE instructions; assemblers prior to 
Assembler H Version 2 do not recognize AMODE and RMODE. 


Note: For more information on AMODE and RMODE, see MVS/XA 
Conversion Notebook and MVS/XA System Programming Library: 
31-Bit Addressing. 


Coding Your Changes to the PLTRLIB Macro 


You must write an SMP USERMOD to change the option default values you need 
to change. The LSMOD job and/or the P3MOD job in your PLI.INSTALL data 
set contains an example of a USERMOD(LSMODn0) written to change the HEAP 
option default values. 


Note: 





The remainder of this discussion refers only to LSMOD, but, if you are using 
P3MOD, the procedure is the same as for LSMOD unless specifically noted 


otherwise. 


Figure 18 shows the sample update statements from the LSMOD job. Notice that 
the PLTRLIB macro is not reproduced in its entirety in the USERMOD. Only the 
lines specifying the HEAP option are coded. All the suboperands for HEAP are 
included on those lines, even the ones not being changed. Notice also that the 
sequence numbers (columns 73 through 80) of the macro statement operands 
match exactly those of the lines in the IBMBXOPT member shown in Figure 17 on 
page 58 which they are to replace. 


./ CHANGE NAME=IBMBXOPT 00120000 
HEAP= (40K, 4K,ANYWHERE, KEEP) , USER MOD xX36000000 
HEAP= (40K,4K, ANYWHERE, KEEP) , USER MOD xX78000000 
/* 90140000 


Figure 18. Sample Update Statements for a USERMOD for Changing Execution-Time Option Defaults 
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Adapting the LSMOD Job to Your Site’s Needs 


Make a copy of the LSMOD job in PLI.IINSTALL so that you can modify it 
according to your needs. 


Examine the copy of source module IBMBXOPT as it exists in PLI.INSTALL to 
see the PLTRLIB operands and suboperands and their associated sequence 
numbers (columns 73 through 80). (A listing of IBMBXOPT is included in the 
LISTJCL output you created earlier.) 


Note: 





It is very important that you look at the IBMBXOPT module in the 
PLI.INSTALL data set you created from your distribution tape to find the 
sequence numbers of the macro operands you want to change. Do not use 


sequence numbers from Figure 17 on page 58, as it is possible that the 
module has been changed since the example in Figure 17 was printed. 


The USERMOD uses the IEBUPDTE utility program to update the source of the 
PLTRLIB macro as coded in the IBMBXOPT module. The update statements you 
create must conform to the syntax requirements of both IEBUPDTE and assembler 
source code as well as the rules listed in “Coding Conventions” on page 58. Refer 
to MVS/370 Utilities for information on IERBUPDTE and to the Assembler 
Language manuals for your system for the rules for coding Assembler Language 
macros. 


Modifying LSMOD: Modify the USERMOD(LSMODn0) to meet your site’s 
requirements. Replace the sample assembler language statements for changing 
HEAP option default values with your site’s execution-time options default update 
statements. These statements follow the ./ CHANGE NAME=IBMBXOPT 
control statement. 


Selecting SMP Control Statements in LSMOD: If you are using LSMOD, continue 
with the instructions in this section. If you are using P3 MOD, skip to “Selecting 
SMP Control Statements in PSMOD” on page 67. 


You can, if you want to, use the EXEC PROC statement in LSMOD to override 
LSPROC’s symbolic parameters. 


LSMOD contains two DD statements that represent the SMP control statements 
for SMP and SMP/E. These are identified by the comments accompanying them. 
Find the grouping of input data that matches your site’s release level of SMP. 
Change the DDNAME on the single matching //SMPCNTLn DD * statement to 
SMPCNTL. 


Now go to “Executing Your USERMOD” on page 67. 
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Selecting SMP Control Statements in P3 MOD: P3MOD is designed to apply 
USERMODs for compiler option defaults modules IELOAS and JELOAT in 
addition to the execution-time option defaults module IBMBXOPT. If you are 
using P3MOD to change compiler option defaults, skip ahead now to ‘‘Changing 
Compiler Option Defaults.” If you are using P3MOD to change only 
execution-time option defaults, you must remember to delete the USERMODs for 
compiler option defaults. These are the ++ USERMOD(P1MODn0) and the ++ 
USERMOD(P1MODn4) statements and the statements following and associated 
with them. 


You can, if you want to, use the EXEC PROC statement in P3MOD to override 
P3PROC’s symbolic parameters. 


P3MOD contains several DD statements that represent the SMP control statements 
for all the possible combinations of SMP level and USERMODs being used. These 
are identified by the comments accompanying them. Find the grouping of input 
data that matches your site’s release level of SMP and the USERMOD you are 
using. Change the DDNAME on the single matching //SMPnnn DD * statement 
to SMPCNTL. The other //SMPnnn DD statements will have no effect. 


Executing Your USERMOD: Now execute job LSMOD or P3MOD to RECEIVE 
and APPLY your modifications to IBMBXOPT. 


If you have violated any of the rules for coding your changes to PLTRLIB, an 
appropriate MNOTE will be issued when IBMBXOPT is reassembled during the 
APPLY step. Correct and recode any statement in the LSMOD or P3MOD job 
that contains an error. Execute an SMP or SMP/E REJECT to restore the 
PLTRLIB macro to its original state (see OS/VS SMP Programmer's Guide or 
SMP/E Reference for more information on REJECT). Then reexecute the job to 
RECEIVE and APPLY your USERMOD. 


Note: 


Do not ACCEPT your USERMOD. This would overwrite the original data 
sets distributed by IBM. After you have APPLYed the USERMOD,, it is 





ready for use. 


Changing Compiler Option Defaults 


This section describes the compiler options for the OS PL/I Optimizing Compiler 
and discusses how to change their IBM-supplied defaults. 


The compiler options and their default values as supplied by IBM on the 
distribution tape are shown in Figure 19 on page 68. The options shown in the 
figure are coded as operands of the two macros that are used to set their default 
values. Batch mode option defaults are set by macro PLIXOPB, and 
conversational mode (TSO) option defaults are set by macro PLIXOPC. These 
macros are discussed further under “‘Specifying Compiler Option Defaults” on 
page 69 and “‘Coding Your Changes to the PLIXOPB and PLIXOPC Macros” on 
page 75. 
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IBM-Supplied Defaults 
Compiler Option Batch Mode 

















































*PRINT={NO| TERMI SYS} 1 (({ {NO| TERM| Not (NO,A,300, 
SYS}][, (class] [,{n)[,m]]}]) applicable 100) 
AGGREGA= {YES | NO} NO NO 
ATTRIBU= {YES | NO} NO NO 
CHARSET=(( {EBCDICIBCD}][(, {481603]) (EBCDIC,60) (EBCDIC,60 
COMPILE= {YES | NO| NOW! NOE] NOS} NOS NOS 
CONTROL='charstring' OPTIMIZE OPTIMIZE 
COUNT= {YES | NO} NO NO 
DECK= {YES | NO} NO NO 
ESD= {YES | NO} NO NO 
FLAG= {I |WIE|S} I W 
FLOW=( {YES |NO}[,n,p]) (NO, 25,10) (NO, 25,10) 
*FMARGIN=( {m,n} (,c)) (2,72) (2,72) 
*F SEQUEN= { (m,n) |NO} (73,80) (73,80) 
GONUMBE= {YES | NO} NO NO 
GOSTMT= {YES | NO} NO NO 
*GRAPHIC=(pad,quote,g,1ld,rd) (4040,427D, (4040,427D, 
42C7,0E,0F) 42C7,0E,0F) 
IMPRECI= {YES | NO} NO NO 
INCLUDE= {YES | NO} NO NO 
INSOURC= {YES [| NO} YES NO 
INTERRU= {YES | NO} NO NO 
LINECOU=n 55 55 
LIST= {YES | NO} NO NO 
LMESSAG= {YES | NO} YES NO 
MACRO= {YES | NO} NO NO 
MAP= {YES | NO} NO NO 
MARGINI={NO| 'character'} NO NO 
MDECK= {YES | NO} NO NO 
NEST= {YES | NO} NO NO 
NUMBER= {YES | NO} NO YES 
OBJECT= {YES | NO} YES YES 
OFFSET= {YES | NO} NO NO 
OPTIMIZ=[ {NO| TIME} ]} | [ {01 2} ] NO|O NO|O 
OPTIONS= {YES | NO} YES NO 
SIZE={n | nk | MAX} MAX MAX 
SOURCE= {YES | NO} YES NO 
STMT= {YES | NO} YES NO 
STORAGE= {YES | NO} NO NO 
SYNTAX= {YES | NO| NOW| NOE| NOS} NOS NOS 
TERMINA={YESINO| (option list**) } NO YES 
*TSTAMP= {YES | NO} NO NO 
*VMARGIN=({m,n}{,c]) (10,100) (10,100) 
*VSEQUEN= { (m,n) | NO} (1,8) (1,8) 
XREF= {YES |NO} | ({YESINO}[,...]]) (NO,F) (NO,F) 







*DELETE=(item[{,item[,...]) - = 


* Options used at installation time only. These options are not available to 
the application programmer. 


** See OS PI/I Optimizing Compiler: Programmer’s Guide for a list of valid 
options. 


Figure 19. Compiler Options and Their IBM-Supplied Defaults 
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If the IBM-supplied compiler option default values satisfy the needs of your 
system, you do not need to do anything further. If, however, you prefer different 
default values, you can change the compiler option defaults now, or you can run 
with the IBM-supplied option defaults for a while to see if they meet the needs of 
your site, and change the default values at some future time. For more detailed 
information on the compiler options used for application programming, see OS 
PL/I Optimizing Compiler: Programmer’s Guide. For more information on the 
options used only at time of installation, see “Operands Representing Compiler 
Options Whose Use is Restricted” on page 72. 


Note: 





You change the compiler option defaults by RECEIVEing and APPLYing 
SMP USERMODs for batch and/or conversational mode option defaults. 
You can install the USERMOD(s) after you have either APPLYed or 
ACCEPTed the PL/I product, but we recommend that you wait until after 


you have ACCEPTed the product, for the following reason: if you have not 
ACCEPTed the product, you will not be able to remove the USERMOD(s) using 
the SMP RESTORE command. 


Allowing for Compiler Option Interdependencies 


Some compiler options, such as STMT, GOSTMT, and NUMBER, are 
interdependent at compile-time. If, for example, you specify STMT at 
compile-time to override the IBM-supplied default of NOSTMT (STMT=NO), the 
compiler automatically performs the compilation as if you had also specified 
GOSTMT and NONUMBER, even if you did not. These interdependencies are 
described fully in OS PL/I Optimizing Compiler: Programmer’s Guide. 


The automatic adjustment of one compiler option based on the setting of another 
compiler option does not take place at installation time. If you code your 
USERMOD to change the IBM-supplied default value for STMT from STMT=NO 
to STMT=YES, you must also change the defaults for NUMBER and GOSTMT. 


Specifying Compiler Option Defaults 


To change the IBM-supplied compiler option defaults, you must create SMP 
USERMODSs to modify the PLIXOPB and PLIXOPC macro instructions in the 
compiler source modules IELOAS and IELOAT. Source module IELOAS contains 
the PLIXOPB macro, whose operands specify the compiler option defaults that will 
be in effect in batch mode. Source module IELOAT contains the PLIXOPC macro, 
whose operands specify the compiler option defaults that will be in effect in 
conversational mode, that is, under TSO. 


The SMP USERMODs use the IEBUPDTE utility program to replace numbered 
statements in the IELOAS and IELOAT modules with equal numbered statements 
from your USERMODs, so you must be sure to match exactly the sequence 
numbers (columns 73 through 80) in your USERMODs to those of the statements 
they are to replace in the IELOAS and IELOAT source modules. 
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The PLI.INSTALL data set on your distribution tape includes a job that contains a 
sample USERMOD(P1MODn0), designed to change some batch mode compiler 
option defaults, and a sample USERMOD(P1MODn4), designed to change a 
conversational mode compiler option default. If you installed the individual 
compiler distribution tape, the sample USERMODs are in the P1MOD job in 
PLI.INSTALL. If you installed the composite tape, the sample USERMODs are in 
job P3MOD, along with USERMOD(L5MODn0) for changing execution-time 
option defaults. The following sections describe how to adapt PLMOD or P3MOD, 
to your site’s needs. 


Description of PLIXOPB and PLIXOPC Operands 


The operands of the PLIXOPB and PLIXOPC macro statements define the 
defaults for the compiler options. Figure 20 on page 71 gives an example of how 
the PLIXOPB macro statement is coded. 
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IELOAS 


Macro Operand (IBM-supplied default) Sequence 
PLIXOPB AGGREGA=NO, DEFAULT X¥000 10000 
ATTRIBU=NO, DEFAULT X00020000 
CHARSET=(EBCDIC,60), DEFAULT X00030000 
COMPILE=NOS, DEFAULT X¥00040000 
CONTROL='OPTIMIZE', DEFAULT X00050000 
COUNT=NO, DEFAULT X00060000 
DECK=NO, DEFAULT X00070000 
ESD=NO, DEFAULT X00080000 
FLAG=I, DEFAULT X00090000 
FLOW=(NO,25,10), DEFAULT X00 100000 
FMARGIN=(2,72), DEFAULT X00110000 
FSEQUEN=(73,80), DEFAULT X¥00120000 
GONUMBE=NO, DEFAULT X00130000 
GOSTMT=NO, DEFAULT X00140000 
GRAPHIC=(4040,427D,42C7,0E,0F), DEFAULT X00150000 
IMPRECI=NO, DEFAULT X00160000 
INCLUDE=NO, DEFAULT X00170000 
INSOURC=YES, DEFAULT X00180000 
INTERRU=NO, DEFAULT X00190000 
LINECOU=55, DEFAULT X00200000 
LIST=NO, DEFAULT X00210000 
LMESSAG=YES, DEFAULT X00220000 
MACRO=NO, DEFAULT X00230000 
MAP=NO, DEFAULT X00240000 
MARGINI=NO, DEFAULT X00250000 
MDECK=NO, DEFAULT X00260000 
NEST=NO, DEFAULT X00270000 
NUMBER=NO, DEFAULT X00280000 
OBJECT=YES, DEFAULT X00290000 
OFFSET=NO, DEFAULT X00300000 
OPTIMIZ=NO, DEFAULT X003 10000 
OPTIONS=YES, DEFAULT X00320000 
SIZE=MAX, DEFAULT X00330000 
SOURCE=YES, DEFAULT X¥00340000 
STMT=YES, DEFAULT X00350000 
STORAGE=NO, DEFAULT X00360000 
SYNTAX=NOS, DEFAULT X00370000 
TERMINA=NO, DEFAULT X00380000 
TSTAMP=NO, DEFAULT X00390000 
VMARGIN=(10,100), DEFAULT X00400000 
VSEQUEN=(1,8), DEFAULT X¥00410000 
XREF= (NO,F) DEFAULT 00420000 
* DELETE=( , , » +» ) DEFAULT 00430000 
END 00440000 
Notes: 


Il. The actual macro coded in the IELOAS source module on your distribution tape may have changed since this 
book was written, so you must look at that module before you attempt to make changes with your USERMOD. 


2. Default values will always be used at compilation time for any options specified in the DELETE option. If you 
plan to use the DELETE option, you must make some changes to IELOAS before assembling it. You must 
remove the asterisk from column one of the DELETE line, add a comma after the XREF specification, and 
add a continuation character in column 72 of the XREF line. 


Figure 20. Example of PLIXOPB Macro in IELOAS Source Module 
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Coding Conventions 


The coding conventions used in Figure 19 on page 68, in the example in 
Figure 20 on page 71, in the PLIXOPB and PLIXOPC macros on your 
distribution tape, and in the following descriptions, are as follows: 


¢« Operands are separated by commas. 


e Uppercase letters, numbers, and punctuation marks must be coded exactly as 
shown. 


e Brackets [], and braces {}, must never be coded. 


e Lowercase letters and words represent variables for which you must substitute 
specific information. 


« Groups of items within braces {} are related. One of the items must be coded. 


¢ Items or groups of items within brackets [] are optional. They may be omitted 
at your discretion. 


If you are satisfied with the IBM-supplied defaults, leave the macros as they are. 

If, however, you want to change an option’s default value, for use in batch mode or 
under TSO, you must specify its corresponding PLIXOPB or PLIXOPC operand in 
the appropriate USERMOD. “Coding Your Changes to the PLIXOPB and 
PLIXOPC Macros” on page 75 explains how to code your USERMOD(s) to 
change those values you need to change. 


Operands Representing Compiler Options Whose Use is Restricted 


Most of the operands of the PLIXOPB and PLIXOPC macro instructions represent 
compiler options that are described in OS PL/I Optimizing Compiler: Programmer's 
Guide. 


Some compiler options, however, designated by a “‘*” in Figure 19, can not be 
used by the application programmer; they are used at installation time, only. These 
are described below. 


PRINT={NO | TERM | SYS} | ([{NO | TERM | SYS}][,[class] [,[n][,mJ]]) 
specifies how SYSPRINT data set is to be allocated when the optimizing 
compiler is started from TSO. 


TERM 
specifies that SYSPRINT is to be allocated to the terminal. 

NO 
specifies that SYSPRINT is to be allocated to a DUMMY data set. 
This is the IBM-supplied default. 

SYS 
specifies that SYSPRINT is to be allocated to the SYSOUT class 
specified by class. 
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class 
specifies the SYSOUT class for SYSPRINT. A is the IBM-supplied 


default. 

n 
specifies the primary allocation in number of lines. 300 is the 
IBM-supplied default. 

m 


specifies the secondary allocation in number of lines. 100 is the 
IBM-supplied default. 


FMARGIN=(7,n[,c]) 
specifies that MARGINS(m,n,c) will be the default when the source is read 
from fixed-length records. The IBM-supplied default for this option is 
(2,72). 


FSEQUEN=NOQO | (7,7) 
specifies defaults for the SEQUENCE compiler option if the source input file 
is F-format. 


NO 
specifies that NOSEQUENCE will be the compiler option default for 
F-format input records. 


(m,n) 
specifies that SEQUENCE (m,n) will be the compiler option default. 


The IBM-supplied default for this option is (73,80). 


GRAPHIC=(pad,quote,g,ld,rd) 
used to replace IBM defaults for the graphic padding, left delimiter, right 
delimiter, graphic quotation mark, and the graphic ““G”’ for graphic string 
data. An example of specifying the GRAPHIC operand is: 


GRAPHIC= (4040 ,427D,42C7, OE, OF) 


Note: If you use the shared library, the GRAPHIC options you specify here 
must match those you specify on the PLRSHR macro used to generate the 
shared library. 


pad 
specifies the hexadecimal padding. The first byte of the padding must 
be the same as the second byte. For example, X'5050' is valid but 
X'5060' is not. The IBM-supplied default is X'4040'. 


quote 
is the hexadecimal representative of the graphic quotation mark. The 
IBM-supplied default is X'427D'. 


is the hexadecimal representation of the graphic “G.” The 
IBM-supplied default is X'42C7'. 
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Note: If the preprocessor is used, you may not specify values X'00' 
through X'06' in either byte of the graphic quotation mark (“‘quote” 
option) or graphic “G” (“‘g” option). 


Id 
specifies the hexadecimal left delimiter. The IBM-supplied default is 
X'OE'. You must use X'OE' for the left delimiter, since this is an 
IBM hardware-generated character. 

rd 


specifies the hexadecimal right delimiter. The IBM-supplied default is 
X'OF'. You must use X'OF' for the right delimiter, since this is an 
IBM hardware-generated character. 


Note: If the preprocessor is used, you may not specify values X'00' 
through X'06' in the left or right delimiter (“ld”’ or ‘“‘rd” options). 
The left or right delimiter also cannot be set to any character in the 
60-character set described in OS and DOS PL/I Language Reference 
Manual. 


TSTAMP=YES | NO 
specifies whether or not the compiler is to place the time and date of 
compilation in the STATIC INTERNAL CSECT, in a location indicated by 
the first word in the STATIC INTERNAL CSECT. This provides a 
time-sharing facility if you prefer not to use the COMPILETIME 
preprocessor function in all your programs. 


YES 
specifies that the time and date of compilation are to be placed in the 
STATIC INTERNAL CSECT. 


NO 


specifies that the time and date of compilation are not to be placed in 
the STATIC INTERNAL CSECT. This is the IBM-supplied default. 


VMARGIN=(m, 7[,c}) 
specifies that MARGINS(m,n,c) will be the compiler option default when the 
source is read from variable- or undefined-length records. 


The IBM-supplied default for this option is (10,100). 
VSEQUEN=NO | (m,n) 
specifies defaults for the SEQUENCE compiler options if the first source 
input file is V- or U-format. 
NO 


specifies that NOSEQUENCE will be the compiler option default for 
V- or U-format input records. 


(m,n) 
specifies that SEQUENCE (m,n) will be the compiler option default. 


The IBM-supplied default for this option is (1,8). 
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DELETE=(item[,iteml,...]) 
specifies that the options in the list cannot be used at compilation time in the 
*PROCESS statement or PARM field of the EXEC statement to override 
the default options established by the PLIXOPB and PLIXOPC macro 
instructions, unless the CONTROL option is also specified with the correct 
password. One or more of the following options can be specified. All but 
DUMP, which cannot be used at installation time, are shown in Figure 19 


on page 68. 

AGGREGA FLOW INTERRU NEST STMT 
ATTRIBU FMARGIN LINECOU NUMBER STORAGE 
CHARSET FSEQUEN LIST OBJECT SYNTAX 
COMPILE GONUMBE LMESSAG OFFSET TERMINA 
COUNT GOSTMT MACRO OPTIMIZ VMARGIN 
DECK GRAPHIC MAP OPTIONS VSEQUEN 
DUMP IMPRECI MARGINI SIZE XREF 
ESD INCLUDE MDECK SOURCE 

FLAG INSOURCE 


Coding Your Changes to the PLIXOPB and PLIXOPC Macros 


You must write an SMP USERMOD to change the batch mode option default 
values you need to change, and a separate USERMOD to change the 
conversational mode (TSO) option default values you need to change. The 
P1MOD job and/or the P3MOD job in your PLIL.INSTALL data set contains 
examples of USERMODs written to change option default values for both batch 
mode and TSO compilations. 


Note: 





The remainder of this discussion refers only to P1IMOD, but, if you are using 
P3MOD, the procedure is the same as for PIMOD unless specifically noted 


otherwise. 


Figure 21 shows sample update statements for batch mode compiler option 
defaults. Notice that the PLIXOPB macro is not reproduced in its entirety in the 
USERMOD. Only the lines that specify the option defaults to be changed are 
written. Notice also that the sequence numbers (columns 73 through 80) of the 
macro statement operands match exactly those of the lines they are to replace in the 
IELOAS member shown in Figure 20. 


./ CHANGE NAME=IELOAS 00001200 
MARGINI='|', USERMOD X00250000 
NEST=YES, USERMOD X00270000 
TSTAMP=YES, USERMOD X00390000 


/* 


Figure 21. Sample USERMOD for Changing Batch Mode Compiler Option Defaults 
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Adapting the PIMOD Job to Your Needs 


Make a copy of the PLMOD job in PLI.INSTALL so that you can modify it 
according to your needs. 


If your site does not use TSO, you will be interested only in the information about 
IELOAS, the batch mode macro source module. Delete from your copy of PLMOD 
the USERMOD(P1MODn4) statement and all the lines following it that pertain to 
IELOAT. 


If your site uses TSO, you must determine the compiler options your site needs for 
both batch and TSO processing. 


The following material discusses the procedure for coding the 
USERMOD(P1MODn0) job for batch mode options, only. The procedure for 
coding the USERMOD(P1MODn4) job for TSO options is exactly the same, 
except that the module name is IELOAT. 


Matching Sequence Numbers: Examine the copy of source module IELOAS as it 
exists in PLI.INSTALL to see the PLIXOPB operands and suboperands and their 
associated sequence numbers (columns 73 through 80). (A listing of IELOAS is 
included in the LISTJCL output you created earlier.) 


Note: 





It is very important that you look at the IELOAS module in the PLIL.INSTALL 
data set you created from your distribution tape to find the sequence numbers 
of the macro operands you want to change. Do not use sequence numbers 


from Figure 20 on page 71, as it is possible that the module has been 
changed since the example in that figure was printed. 


The USERMOD uses the IEBUPDTE utility program to update the source of the 
PLIXOPB macro as coded in the IELOAS module. The update statements you 
create must conform to the syntax requirements of both IEBUPDTE and assembler 
source code as well as the rules listed in ““Coding Conventions” on page 72. Refer 
to MVS/370 Utilities for information on IEBUPDTE and to the Assembler 
Language manuals for your system for the rules for coding Assembler Language 
macros. 


Modifying PIMOD: Modify the P1MOD job to meet your site’s requirements. 
Replace the sample assembler language statement for changing an option’s default 
value (as shown in Figure 21 on page 75) with statements specifying your site’s 
desired compiler option defaults. These statements follow the ./ CHANGE 
NAME=IELOAS control statement. 


If you are also changing TSO option defaults, put your replacement statements for 
those after the ./ CHANGE NAME=IELOAT control statement. 


If your site does not use TSO, or if you are not changing TSO option defaults, you 
must remember to delete the statements relating to IELOAT. In the same way, if 
you are changing TSO option defaults but not those for batch mode, you must 
delete those statements relating to IELOAS. 
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Selecting SMP Control Statement in PIMOD: If you are using P1MOD, continue 
with the instructions in this section. If you are using P3 MOD, skip to “Selecting 
SMP Control Statements in PS3MOD” on page 77. 


You can, if you want to, use the EXEC PROC statement in P1MOD to override 
P1PROC’s symbolic parameters. 


P1MOD contains several DD statements that represent the SMP control statements 
for all the possible combinations of SMP level and USERMODS being used. These 
are identified by the comments accompanying them. Find the group of input data 
that matches your site’s release level of SMP and the set of options (batch mode 
and/or TSO) you are using. Change the DDNAME on the single matching 
//SMPCNTLn DD * statement to SMPCNTL. 


Now go to “Executing Your USERMOD(s).”’ 


Selecting SMP Control Statements in P3 MOD: P3MOD is designed to apply 
USERMODs for execution-time option defaults module IBMBXOPT in addition to 
the compiler option defaults modules IELOAS and IELOAT. If you are using 
P3MOD to change option defaults in one or two, but not all three, modules, you 
must remember to delete the USERMOD statements and the lines following them 
that relate to the unchanged modules, before you run P3MOD. 


You can, if you want to, use the EXEC PROC statement in P3MOD to override 
P3PROC’s symbolic parameters. 


P3MOD contains several DD statements that represent the SMP control statements 
for all the possible combinations of SMP level and USERMODs being used. These 
are identified by the comments accompanying them. Find the grouping of input 
data that matches your site’s release level of SMP and the USERMODs you are 
using. Change the DDNAME on the single matching //SMPnnn DD * statement 
to SMPCNTL. The other //SMPnnn DD statements will have no effect. 


Executing Your USERMOD(s): Now execute job PIMOD or P3MOD to 
RECEIVE and APPLY your modifications to IELOAS and/or IELOAT. 


If you have violated any of the rules for coding your changes to PLIXOPB or 
PLIXOPC, an appropriate MNOTE will be issued when IELOAS or IELOAT is 
reassembled during the APPLY step. Remember that some of the compiler options 
are interdependent, as explained in “Allowing for Compiler Option 
Interdependencies” on page 69. If you coded your USERMOD to change the 
IBM-supplied default value for one option without changing those that relate to it, 
an IELnnnn error message will explain the inconsistency in the option settings. 
You must change the noted option defaults accordingly. Correct and recode any 
statement in the PLMOD or P3MOD job that contains an error. Execute an SMP 
or SMP/E REJECT to restore the PLIXOPB and/or PLIXOPC macros to their 
original state (see OS/VS SMP Programmer’s Guide or SMP/E Reference for more 
information on REJECT). Then reexecute the PIMOD job to RECEIVE and 
APPLY your USERMOD. 
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Note: 


Do not attempt to ACCEPT your USERMOD. This will overwrite the 
original data sets distributed by IBM. After you have APPLYed the 





USERMOD,, it is ready for use. 


Rerunning the Sample Program 


After APPLYing your USERMOD(s), you might want to rerun the sample program 
to see that the new option defaults are in effect. See Chapter 6, “‘Running the 
Installation Verification Program” on page 47. 


Modifying the PL/I-Supplied Error Exit Routine 


IBM supplies as part of the resident library a PL/I error exit routine named 
IBMBEER. You can use the IBMBEER routine to terminate a PL/I application 
program with an abnormal termination condition. This exit will be entered when 
the ERROR condition is raised and the standard system action is taken, that is, 
under one of the following conditions: 


e No ERROR on-unit 


e An ERROR on-unit that does not terminate with a GOTO, STOP, or EXIT 
statement 


If you need an abnormal termination for the situation described above, you must 
modify the IBM-supplied module IBMBEER in the PL/I Resident Library, as 
indicated below. 


Altering the IBM-Supplied IBMBEER Module 


IBMBEER is called by the program termination routine under the conditions listed 
above. On return from IBMBEER, the program termination routine inspects the 
contents of register 15 and, if not zero, executes an ABEND macro, using the 
contents of register 15 as the argument of ABEND. 


The IBM-supplied IBMBEER module sets register 15 to zero and returns. Thus an 
abend does not occur. If you want an abend to occur, you must modify the 
IBMBEER module to set register 15 to a value that can be passed to the ABEND 
macro as an argument. 


The first byte of the value passed to ABEND is a flag byte. The flag byte has the 
following meanings: The flag byte has the following meanings: 


DUMP (128) 

NO DUMP (0) 
STEP ABEND (64) 
TASK ABEND (0) 


1XXX XXXX 
Oxxx XXxXX 
x1XX XXXX 
xOxx XXxXX 


The last three bytes of the value passed to ABEND contain a value that will 
become the ABEND code. The value must be greater than 0 and less than 4096. 
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Figure 22 on page 79 shows a replacement module that will cause a step abend 
with a different ABEND code depending on whether an ERROR on-unit has been 
executed. Note that the member name of IBMBEER in the PL/I Resident Library 


is IBMBEERA. 
IBMBEER1 CSECT 
IBMBEER1 AMODE 
IBMBEER1 RMODE 
ENTRY 
USING 
IBMBEERA EQU 
LTR 
BM 
L 
BR 
NOERR EQU 
L 
BR 
* 
DUMP EQU 
STEP EQU 
USERCOD1 EQU 
USERCOD2 EQU 
DS 
RETNCOD1 DC 
DC 
RETNCOD2 DC 
DC 
END 
Notes: 


ANY 

ANY 
IBMBEERA 
*,15 

* 

1,1 

NOERR 
15,RETNCOD1 
14 

* 


15,RETNCOD2 
14 


128 
64 
3001 
3002 
OF 


CSECT NAME 


DEFINE ENTRY POINT 
ADDRESSABILITY 
ENTRY POINT 
BRANCH 


ERROR ON-UNIT 


NO ERROR ON-UNIT 


128=DUMP, O=NO DUMP 

64=STEP ABEND, O=TASK ABEND 

USER COMPLETION CODES (MUST BE 
GREATER THAN O AND LESS THAN 4096) 


AL1 (DUMP+STEP) 


AL3 (USERCOD1 ) 


AL 1 (DUMP+STEP) 


AL3 (USERCOD2) 


I. Only Assembler H Versions 2 and later recognize AMODE and RMODE 
statements. If you are not using this assembler, or you do not need XA support, 
omit these statements. 


2. If this module is used to replace the IBM-supplied module IBMBEER in the 
resident library and if the program is terminated because of the ERROR 
condition, an abend will occur. The ABEND code will be 3001 if there was an 
ERROR on-unit and 3002 if there was not. 


Figure 22. Example of a User-Written IBMBEER Replacement Module 





You can include your IBMBEER module in the resident library, PLI.LPLIBASE, by 
link-editing with the object module for the user’s IBMBEER, as shown in 
Figure 23, or by using an SMP USERMOD statement. 
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EXEC LKED, PARM='LIST,NCAL, RENT, REFR, SIZE=(128K, 24K) ' 

//BEER DD DSN=IBMBEER. OBJECT .MODULE , DISP=SHR 
//SYSLMOD DD DSN=PLI.PLIBASE, DISP=OLD 
//SYSLIN DD * 

INCLUDE BEER 

ENTRY IBMBEERA 

NAME IBMBEERA(R) 

* 


Figure 23. JCL to Include User-Written IBMBEER in PLI.PLIBASE 


Note: SMP does not keep track of a user-written IBMBEER. Therefore, if you 
apply corrective or preventive service to the resident library, you must repeat the 
above procedure to include your IBMBEER module. 


Tuning Your OS PL/I Product 


There are two things you can do after you install the OS PL/I product to improve 
its performance. These are: 


e« Using the shared library, and 
e Adding transient library modules to the link pack area 
You can also disable the PL/I fast initialization facility if storage for PL/I program 


load modules is limited. These procedures are discussed in 
Chapter 9, “Postinstallation Tuning” on page 81. 
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Chapter 9. Postinstallation Tuning 


Tuning is the process of adjusting your product, or parts of it, to improve its 
efficiency and/or the overall performance of your system. This chapter discusses 
some techniques for tuning the OS PL/I libraries and compiler to best suit the 
needs of your site. It contains discussions of the following: 


e Using the shared library 


— Establishing compatibility between release levels 
— Creating the shared library 

— Loading the shared library into main storage 

— Using IBM-supplied cataloged procedures 

— Creating the shared library for use under CICS 


¢« Adding transient library modules to the link pack area 


e Disabling the PL/I fast initialization/termination facility if storage for PL/I 
program load modules is limited at your site 


Using the Shared Library 


OS PL/I allows you to select groups of resident library modules and place them in 
a shared library in the MVS link pack area. During link-edit of a PL/I program’s 
object module, a program stub is substituted for each resident library module 
referred to that resides in the link pack area. When multiple PL/I application 
programs execute concurrently, they can share a single copy of any resident library 
module residing in the link pack area. 


Use of the shared library is optional. If you choose to use it, you can create your 


shared library at any time after you have executed the SMP APPLY command to 
install the resident library. 


Chapter 9. Postinstallation Tuning 81 


Deciding Whether to Create the Shared Library 


If your site executes many OS PL/I application programs concurrently, using the 
shared library can be beneficial. There are also, however, some disadvantages to 
using the shared library. The advantages and disadvantages of using the shared 
library are listed below: 


Advantages: 


Composite load modules representing OS PL/I application programs need 
less DASD storage when the PL/I applications use resident library routines 
that reside in the shared library. 


These smaller composite load modules need less time to be loaded into 
storage for execution. 


These smaller composite load modules need less main storage. 


If all the resident library modules are in the shared library, corrective or 
preventive maintenance to resident library modules in the shared library 
becomes available to PL/I applications after the next initial program load 
(IPL), without the applications needing to be link-edited again. 


Sites that use primarily PL/I applications might see a decrease in paging 
rate because frequently used resident library modules are more likely to 
remain in main storage. 


Disadvantages: 


The shared library is not supported by SMP. Therefore, when you apply 
corrective or preventive maintenance or a USERMOD to a resident library 
module residing in the shared library, you must rebuild your shared library 
so that it will contain the updated module. You can rebuild the shared 
library by rerunning Job 2 as described in “Running Job 2” on page 95. 


If you do not place all the resident library modules in the shared library, it 
is possible that applying a program temporary fix (PTF) can cause a load 
module execution to fail because it uses resident library modules at 
different service levels. This can happen if a PTF affects more than one 
module, one or more but not all of which are in the shared library. 


If you rebuild the shared library but forget to link-edit again applications 
that use modules not in the shared library, the resident library modules not 
at the same service level might no longer be compatible. 


Establishing Compatibility Between Releases When Using Shared Library 


Different release levels of the optimizing compiler and the libraries will produce 
compatible executions only if the options specified for the shared library are exactly 
the same as those specified at any previous generation of the shared library, and 
only if a/l resident library modules were in the old shared library and you are 
placing ail of them in the new shared library. 


82 OS PL/I Installation Guide for MVS 


When you install a new release of the resident library, the modules in the link pack 
area are still from the old release, so programs link-edited at that release level will 
continue to work. When you create a new shared library, if a previously link-edited 
program contains only program stub pointers to the shared library, then the 
program will continue to work with the new shared library as if it had been 
link-edited again with the new library. 


If, however, your program load module contains a mixture of program stubs and 
complete modules from the old resident library, you have a mixture of releases; this 
can cause failures at execution time. 


If not all of the resident library modules are in the shared library, then all programs 
previously compiled and link-edited using the PLISHRE module from the old 
shared library must be link-edited with the new shared library. 


Compatibility between Shared Libraries Generated with Different Options 


In general, if a program was link-edited with a shared library generated with one 
set of options, it will fail in execution if you run it on a system that has a different 
set of shared library options specified. You must link-edit the program again on 
the new system before you attempt to execute it. 


Creating the Shared Library 


To build the shared library, you must run two jobs. The first job, which you create, 
assembles a macro instruction in which you have specified the groups of modules 
you require in the shared library, and the environment (tasking, nontasking, or 
both) in which you wish to use it. The second job, which is assembler output from 
Job 1, creates five modules and link-edits four into the SYS1.PLIBASE link library 
and one into the SYS1.PLITASK link library or to the target libraries you chose 
when you installed the resident library. 


Three of the modules Job 2 places in SYS1.PLIBASE (or your equivalent library) 
belong in the link pack area. There are two ways to put them there: 


e Include the modules in SYS1.LPALIB, or 
e Use the MLPA (modified link pack area) facility of MVS. 


These methods are described in “‘Loading the Shared Library into Common 
Storage” on page 96. 


Before you can use the shared library modules in the link pack area, you must 
perform an initial program load (IPL). For information on using the shared library, 
see OS PL/I Optimizing Compiler: Programmer's Guide. 


Note: If you are using the XF Assembler to create your shared library, you will 
need to restrict the number of modules you put in it. “Using the XF Assembler to 
Create a Shared Library” on page 97 describes how to calculate the number of 
modules you can put in your shared library. 
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Running Job 1 


The first step in the creation of the shared library is to select the groups of modules 
that you require in the shared library (see “Shared Library Macro Operand 
Descriptions” on page 85 for groups of modules available). You then specify the 
groups of modules in the PLRSHR macro instruction as shown in Figure 24. 


As noted above, if you are using the XF Assembler, you must limit the number of 
modules you specify. If you do not have an extended architecture system, you 
might also want to limit the modules you specify to frequently used modules only, 
to make the best use of the storage available. Note that the housekeeping and 
basic error handling modules are always included in the shared library. 


If you can, however, and especially if you have the storage constraint relief of 
MVS/XA, we recommend that you place all of your resident library into the shared 
library. Remember, though, that SMP does not keep track of modules in the link 
pack area, so when you apply maintenance to resident library modules in the link 
pack area, you must rerun Job 2 to rebuild the shared library and ensure that those 
modules are updated. 





//SHRLIB JOB === 


EXEC PGM=ASMBLR, PARM= (DECK, NOLOAD) 

//SYSUT1 DD UNIT=SYSSQ,DISP=(NEW,PASS) , 
// SPACE=(1024, (500,150) ,, , ROUND) ,DSN=&&SYSUT1 
//SYSUT2 DD UNIT=SYSSQ,DISP=(NEW,PASS) , 
// SPACE= (1024, (300,150) ,,,ROUND) ,DSN=&&SYSUT2 
//SYSUT3 DD UNIT=SYSDA,DISP=(NEW,PASS) , 

SPACE= (1024, (300,150),,,ROUND) ,DSN=&&SYSUT3 
//SYSPRINT DD SPACE=(121, (500,40) ,RLSE) ,SYSOUT=A, 

DCB= (RECFM=FB, LRECL=121, BLKSIZE=3509) 
//SYSPUNCH DD UNIT=TAPE, LABEL=(1,NL) 
//SYSLIB DD DSN=PLI .SHRMAC, DISP=SHR 

i 


//SYSIN DD 


ICTL 1,71,3 
PUNCH ‘SPECIFY HERE JOB STATEMENT OF YOUR OWN CHOOSING' 


PLRSHR MODES=(BASE) , ARRAY=(BASIC.LOGIC.LEAF, 
FIXED.PROD.SUM, FLOAT. PROD.SUM.POLY,EXTND.PROD.SUM.POLY) , 
CONV= (ARITH.CHAR.DEC.BIN.BIT,EDIT,BIT.CHAR.BIN, 

CHAR. ARITH.BIT.PIC,PIC.CHECK.DEC.BIT,EXTND, COMPLEX), 
IO= (DATA. OUTPUT, EDIT.OUTPUT) , 


JOBSTMT=SUPPLIED, 


MFUNC=(RETC,TIME,DATE,DELAY) , 
STRGS= (BIT. LOGIC. COMPARE. ASSIGN. INDEX.SUBSTR, 


PS OS OS OS OS OS OG DS 


CHAR. INDEX. TRANS .SUBSTR, STRING.BIF.PV) 


END 
/* 


Figure 24. Example Job to Specify the Shared Library 
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Coding your Shared Library Macro Instruction 


You must first determine which modules you wish to include in your shared library. 
The list on the next few pages describes the operands of the PLRSHR macro in 
terms of the functions of the modules each operand represents. When you have 
decided which modules will be most frequently used at your site and in which 
environments, you are ready to code your macro. 


Coding Conventions: The coding conventions used in Figure 24 on page 84 and in 
“Shared Library Macro Operand Descriptions” for coding the PLRSHR macro are 
as follows: 


e Parameters are separated by commas. 


e Uppercase letters, numbers, and punctuation marks must be coded exactly as 
shown. 


¢« Brackets [], and braces {}, must never be coded. 


e Lowercase letters and words represent variables for which you must substitute 
specific information. 


¢« Groups of items within braces {} are related. One of the items must be coded. 


e Items or groups of items within brackets [] are optional. They may be omitted 
at your discretion. 


Shared Library Macro Operand Descriptions 


The following list describes the operands of the PLRSHR macro instructions. Use 
it to determine which modules you want to include in your shared library, and then 
code your macro. See Figure 24 on page 84 for an example of how to code this 
macro instruction. 


i [MODES=(operand[,operand...])] 


[,ARRAY=(operand[,operand...])] 
MODES = ((BASE][,TASK]) 


[,CMATH=(operand[,operand...])] 

[,CONTL=(operand[,operand...])] 
[,CONV=(operand[,operand...])] 
[,GRAPHIC=operand] 

specifies whether basic, or tasking, or both basic and tasking shared library 

modules are required. If both are required, then MODES=(BASE,TASK) 

must be specified. The macro cannot be used twice to create basic and 

tasking modules for different function groups, because some routines are 

















[,1O = (operand[,operand...])] 
[, JOBSTMT=operand] 
[MFUNC=(operand[,operand...])] 
[ RMATH=(operand[,operand...])] 
[ STORG=(operand[,operand...])] 
[ STRGS=(operand[,operand...])] 
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combined into a single module for both tasking and nontasking functions. 
The IBM-supplied default is MODES=BASE. 


ARRAY = 
modules associated with array handling and the SUM, PROD, and POLY 
built-in functions. 


BASIC[.LOGIC][.LEAF][.EVENT] 


LOGIC 
logical operations on arrays ALL and ANY 


LEAF 
interleaved array module 


EVENT 
arrays of event variables 


FIXED[.PROD][.SUM] 


PROD 
the PROD built-in function module for fixed binary and fixed 
decimal elements. 


SUM 
the SUM built-in function module for fixed decimal elements. 


FLOAT{[.PROD][.SUMI][.POLY] 


PROD 
the PROD built-in function module for short and long precision 
floating point element. 


SUM 
the SUM built-in function module for short and long precision 
floating point elements. 


POLY 
the POLY built-in function module for short and long precision 
floating point elements. 


EXTND[.PROD][.SUMI[.POLY] 


PROD 
the PROD built-in function module for extended precision 
floating point elements. 


SUM 
the SUM built-in function module for extended precision 
floating point elements. 


POLY 


the POLY built-in function module for extended precision 
floating point elements. 
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CMATH= 
modules associated with COMPLEX variable arithmetic operations and 
built-in function with COMPLEX variable arguments. 


FIXED[.ADD}[.MULT][.ABS] 
the modules associated with the following built-in functions with 
complex fixed decimal arguments. 


ADD 
the module associated with the ADD built-in function 


MULT 
the module associated with the MULTIPLY built-in function 


ABS 
the module associated with the ABSOLUTE built-in function 


SHORT[.TRIG][.SQRT][.LOG][.ABS]{.MULT][.DIV] 
[.EXPN][.ATRIG] 
the modules associated with the following built-in functions with 
COMPLEX SHORT precision floating point arguments will be made 
resident. 


TRIG 
the trigonometric functions SIN, COS, and TAN 


SQRT 
the square root function 


LOG 
the LOG and EXP built-in function 


ABS 
the ABSOLUTE built-in function 


MULT 
the module associated with the MULTIPLY built-in function 


DIV 
the module associated with the DIVIDE built-in function 


EXPN 
the modules associated with exponentiation 


ATRIG 
the trigonometric function ATAN 


~LONG[.TRIG][.SQRT][.LOG][.ABS][.MULT]|.DIV] 
[.EXPN][.ATRIG] 
the modules associated with the above built-in functions with 
COMPLEX LONG floating-point arguments will be made resident. 
(For an explanation of subgroup elements, see CMATH SHORT.) 
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EXTNDI[.TRIG][.SQRT][.LOG][.ABS][.MULT][.EXPN][.ATRIG] 
the modules associated with the above built-in functions with 
COMPLEX EXTENDED precision floating-point arguments will be 
made resident. (For an explanation of subgroup elements, see 
CMATH SHORT.) 


CONTL= 
module associated with WAIT, PRIORITY and COMPLETION in a tasking 
and/or nontasking environment will be made resident. 


TASK[.WAIT][.CPLN][.PRTY] 
the option is only valid if MODES=(TASK,BASE) has been specified. 


‘WAIT 
modules associated with the WAIT statement in a tasking 
system. 


CPLN 
modules associated with the COMPLETION pseudovariable in 
a tasking system. 


PRTY 
modules associated with the PRIORITY pseudovariable in a 
tasking system. 


NOTASK[.WAIT][.CPLN][.PRTY] 
the option is only valid if MODES is not specified and the default 
MODES=BASE is assumed, or if MODES=BASE or 
MODES=(BASE,TASK) is specified. 


WAIT 
modules associated with the WAIT statement in a nontasking 
system. 


CPLN 
modules associated with the COMPLETION pseudovariable in 
a nontasking system. 


PRTY 
modules associated with the PRIORITY pseudovariable in a 
nontasking system. 


CONV= 
specifies that selected parts of the conversion package will be made resident. 


ARITH[.CHAR][.DEC]{.BIN][.BIT] 


CHAR 
arithmetic to character conversions. 


DEC 
arithmetic to decimal conversion. 
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BIN 
arithmetic to binary conversions. 


BIT 
arithmetic to bit conversions. 


EDIT (no subgroup defined) 
modules associated with edit stream I/O conversions 


BIT|.CHAR][.BIN] 


CHAR 
bit to character conversions. 


BIN 
bit to binary number conversions. 


CHAR[.ARITH]I.BIT][.PIC] 


ARITH 
character to arithmetic conversions. 


BIT 
character to bit conversions. 


PIC 
picture character conversions. 


PIC[.CHECK][.DEC][.BIT] 


CHECK 
checks pictured character and pictured arithmetic input. 


DEC 
picture decimal conversions 


BIT 
picture bit conversions 


EXTND (no subgroup defined) 
converting extended precision floating point variables. 


COMPLEX (no subgroup defined) 
converting complex variables. 


GRAPHIC={YES | NO | (pad,quote,g,|d,rd)} 
specifies the graphic padding, left delimiter, right delimiter, graphic quotation 
mark, and the graphic ‘“‘“G” for graphic string data. An example of specifying 
the GRAPHIC operand is: 


GRAPHIC= (4040, 427D,42C7, OE, OF) 


Note: The GRAPHIC options you specify for the shared library must match 
the GRAPHIC options you specified for the compiler. 
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pad 


quote 


rd 


Note: 


specifies that the IBM-supplied default options for the graphic 
padding, graphic quotation mark, graphic ““G,” left delimiter, and right 
delimiter will be used. 


specifies that no default options are required. 


specifies the hexadecimal padding. The IBM-supplied default is 
X'4040'. The first byte of the padding must be the same as the 
second byte. For example, X'5050' is valid but X'5060' is not. 


is the hexadecimal representation of the graphic quotation mark. The 
IBM-supplied default is X'427D"'. 


is the hexadecimal representation of the graphic “G.” The 
IBM-supplied default is X'42C7'. 


Note: If the preprocessor is used, you may not specify values X'00' 
through X'06' in either byte of the graphic quotation mark 
(‘“‘quote” option) or graphic “G” (“g” option). 


specifies the hexadecimal left delimiter. The IBM-supplied default is 
X'OE'. You must use X'OE' for the left delimiter, since this is an 
IBM hardware-generated character. 


specifies the hexadecimal right delimiter. The IBM-supplied default is 
X'OF'. You must use X'OF' for the right delimiter, since this is an 
IBM hardware-generated character. 


If the preprocessor is used, you may not specify values X'00' through 


X'06' in the left or right delimiter (“‘ld” or “‘rd.”’ options). The left or right 
delimiter also cannot be set to any character in the 60-character set 
described in OS and DOS PL/I Language Reference Manual. 


modules associated with I/O will be made resident. 


DATA[.INPUT][.OUTPUT] 
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INPUT 
the modules associated with GET DATA 


OUTPUT 
the modules associated with PUT DATA 


EDIT[.INPUT][.OUTPUT] 


INPUT 
the modules associated with GET EDIT 


OUTPUT 
the modules associated with PUT EDIT 


LIST[.INPUT][.OUTPUT] 


INPUT 
the modules associated with GET LIST 


OUTPUT 
the modules associated with PUT LIST 


COPY (no subgroup defined) 
the module associated with the COPY option. 


RECORD (no subgroup defined) 
the module associated with RECORD I/O 


EXCL (no subgroup defined) 
the module associated with EXCLUSIVE files. 


JOBSTMT = 
to indicate whether the macro is to generate a JOB statement or whether you 
will provide one by giving a PUNCH statement for, or placing a REPRO 
statement immediately preceding, your JOB statement and any continuation 
lines of the JOB statement. 


NOTSUPPLIED (no subgroup defined) 
no user-written JOB statement will be in the input stream; a default 
job statement will be generated. 


//PLRSHR JOB (1),,SHARED LIBRARY GEN’, MSGLEVEL=1 
This option will be the default. 


SUPPLIED (no subgroup defined) 
you will supply a JOB statement in the input stream. 


MFUNC = 
specifies that modules associated with various miscellaneous functions will be 
made resident. 


SORT (no subgroup defined) 
modules associated with the call of PLISORT 


DEBUG[.DUMP]|.FLOW] 
modules used with debugging aid 


DUMP 
the modules associated with the call of PLIDUMP. 
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FLOW 
the module associated with the FLOW and COUNT options. 


RETC (no subgroup defined) 
modules associated with the call of PLIRETC. 


CKPT (no subgroup defined) 
modules associated with the call of PLICKPT. 


DISP (no subgroup defined) 
modules associated with the DISPLAY statement. 


TIME (no subgroup defined) 
modules associated with the TIME built-in function. 


DATE (no subgroup defined) 
modules associated with the DATE built-in function. 


DELAY (no subgroup defined) 
modules associated with the DELAY statement. 


FETCH (no subgroup defined) 
modules associated with dynamic FETCH and RELEASE. 


RMATH= 
modules used in the REAL arithmetic operations and functions. 


FIXED[.ADD][.MULT][.DIV] 
the modules associated with the following operations and built-in 
functions with fixed decimal or binary arguments. 


ADD 
the module associated with the ADD built-in function 


MULT 
the module associated with the MULTIPLY built-in function 


DIV . 
the module associated with the DIVIDE built-in function 


SHORT[.TRIG][.ATRIG][-HYPER][.AHYPER][.SQRT] 
[.EXPN][.LOG][.ERF] 
the modules associated with the following operations and built-in 
functions with fixed decimal or fixed binary arguments. 


TRIG 
the trigonometric functions SIN, COS, TAN, SIND, COSD, 
TAND. 


ATRIG 


the trigonometric functions ASIN, ACOS, ATAN, ATAND, 
ASIND, ACOSD 
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HYPER 
the hyperbolic functions SINH and TANH 


ANYPER 
the hyperbolic function ATANH 


SQRT 
the square root function 


EXPN 
modules associated with exponentiation 


LOG 
the LOG and EXP built-in functions 


ERF 
evaluation of the error function 


LONG[.TRIG][.ATRIG][.HYPER][.AHYPER][.SQRT] 
[.EXPN)[.LOG][.ERF] 
the modules associated with the above built-in functions with LONG 
floating-point arguments will be made resident. (For an explanation, 
see RMATH SHORT.) 


EXTND[.TRIG][.ATRIG][.HYPER][.AHYPER][.SQRT][.ERF] 
the modules associated with the above built-in functions with 
EXTENDED precision floating-point arguments will be made 
resident. (For an explanation, see RMATH SHORT.) 


STORG= 
specifies that storage management and error handling modules will be in the 
shared library. 


ERR[-ONCODE]{.ONLOC][.CHECK] 


ONCODE 
The module associated with the ONCODE built-in function will 
be made resident. 


ONLOC 
The module associated with the ONLOC built-in function will 
be made resident. 


CHECK 
The module associated with the CHECK condition will be made 
resident. 


PCONI.CTL][.AREA] 
CTL 


The module associated with allocation and freeing of 
CONTROLLED variables will be made resident. 
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AREA 
The module associated with allocation and freeing an AREA 
and assignment between AREAs will be made resident. 


STMAP (no subgroup defined) 
The modules associated with structure mapping will be made resident. 


STRGS= 
specifies that string handling modules will be made resident. 


BIT[.LOGIC]{.COMPARE][.ASSIGN]|.INDEX][.REPEAT] 
[. VERIFY][.SUBSTR][.BOOL] 
the modules associated with bit built-in functions and logical 
operations will be made resident. 


LOGIC 
the logical bit operation modules: AND, OR, and NOT 


COMPARE 
the modules associated with comparison of bit strings 


ASSIGN 
the modules associated with assignment of bit strings 


INDEX 
the bit string built-in function INDEX 


REPEAT 
the bit string built-in function REPEAT 


VERIFY 
the bit string built-in function VERIFY 


SUBSTR 
the bit string built-in function and pseudovariable SUBSTRING. 


BOOL 
the bit string built-in function BOOL 


CHAR[.INDEX][.TRANS][.REPEAT][.VERIFY][.SUBSTR] 
the modules associated with the character built-in functions will be 
made resident. 


INDEX 
the character string built-in function INDEX 


TRANS 
the character string built-in function TRANSLATE 


REPEAT 
the character string built-in function REPEAT 
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VERIFY 
the character string built-in function VERIFY 


SUBSTR 
the character string built-in function and pseudovariable 
SUBSTRING 


STRING[.BIF][.PV] 
the modules associated with the STRING built-in function and 
pseudovariable will be made resident. 


BIF 
the STRING built-in function module 


PV 
the STRING pseudovariable module 


Assembling the PLRSHR Macro 


Running Job 2 


When you have selected and specified the groups of modules in the PLRSHR 
macro instruction, create a job similar to the one in Figure 24 on page 84. The 
SYSLIB DD statement refers to the shared library system generation macro data 
set containing the PLRSHR macro added during resident library installation. Run 
this job to assemble the PLRSHR macro instruction, the output of which is 
assigned to SYSPUNCH and is the complete job to be run as Job 2. SYSPUNCH 
may be tape, card, or disk. 


Note: When specifying the PLRSHR macro instruction you will select either 
JOBSTMT=NOTSUPPLIED or SUPPLIED. If your site has specific job 
statement requirements, you must use the SUPPLIED parameter, and write a 
PUNCH statement to include the job statement you supply, as shown in Figure 24 
on page 84. 


If you use the NOTSUPPLIED parameter, the following job statement is 
automatically generated: 


//PLRSHR JOB (1),'SHARED LIBRARY GEN' ,MSGLEVEL=1 


Job 2 is the last in the process of creating the shared library. This job will store the 
shared library in auxiliary storage in the SYS1.PLIBASE or SYS1.PLITASK library 
or in the equivalent private libraries you have chosen. 


Note: If you installed the resident library into private library data sets as we 
recommended, make sure you change the library names in Job 2 from 
SYS1.PLIBASE and SYS1.PLITASK to your private library names before you 
run it. 


Job 2 is the SYSPUNCH output from the first job. According to the operand 
specified for JOBSTMT, the input for Job 2 will either start with the job statement 
you supplied or a default job statement. Start a reader to the SYSPUNCH data set 
and run Job 2. 
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The job will assemble and link-edit the following modules: 


IBMBPSRA onto its basic library, SYS1.PLIBASE, and IBMTPSRA onto the 
tasking subroutine libraries, SYS1.PLITASK. These will be used subsequently 
when running PL/I optimizing programs in a shared library environment to 
resolve subroutine library references to the resident shared library modules. 


Note: During the link-edit of these modules, you will receive the following 
message from the linkage editor: 


IEWO461 SYMBOL PRINTED IS AN UNRESOLVED EXTERNAL REFERENCE 


IEW0461 is issued during the link-edit of the shared library modules. These 
references will later be resolved when a compiled application program is 
link-edited. 


IBMBPSMA, IBMBPSLA, and IBMTPSLA, onto SYS1.PLIBASE. These 
shared library modules will consist of subroutines from the basic or the basic 
and tasking subroutine libraries, selected according to the options specified in 
the PLRSHR macro. 


The output from the link-edit steps for the above modules gives the storage 
requirements for the link pack area. 


You can test your shared library modules, without making them resident in 
common storage, by link-editing them into a private library and accessing them 
with a STEPLIB DD statement. 


Loading the Shared Library into Common Storage 


Using the MLPA Facility 


Before you can use the shared library, you must load it into MVS common storage, 


‘by one of two methods: 


You can include the modules in SYS1.LPALIB, and then perform an initial 
program load (IPL) specifying the CLPA (create link pack area) option. 


The drawback of this approach is that, if you regenerate your system with the 
shared library permanently resident in SYS1.LPALIB, you must also rebuild 
your shared library. 


You can use the MLPA (modified link pack area) facility of MVS. This 
method causes the shared library modules to be loaded into common storage 
only until the next initial program load (IPL). Using this method assures that 
your shared library need not be rebuilt if you replace or upgrade your system. 


You can place the shared library modules created by job 2 into a private library 
from which they can be made resident in common storage at IPL time. The 
procedure is as follows: 


1. 


You must place the modules in a data set contained in the MVS linklist 
concatenation member in SYS1.PARMLIB (member name LNKLSTxx). 
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2. You must add the load module names and aliases to an existing MLPA member 
(IEALPAxx), or create a new MLPA member. 


3. When you want to use the shared library, you must perform an initial program 
load (IPL), specifying the MLPA member that now contains the shared library 
module names. 


The Initialization and Tuning Guide for your system contains more information on 
and examples of creating MLPA members. 


Loading the Shared Library for Use under CICS 


If you want to use the shared library under CICS, you must specify the 
PLISHRE=YES option of CICS System Initialization Table (SIT). In addition, 
you must make the PL/I shared library modules available to CICS. There are two 
ways to do this: 


e Load the shared library modules into MVS common storage using one of the 
methods described in “Loading the Shared Library into Common Storage” on 
page 96. This enables batch, CICS, and TSO applications to use the same 
shared library. 


e Place the shared library modules into a private library. If CICS does not find 
the shared library modules in MVS common storage, it will attempt to load 
them into its region. In this case, only CICS applications will be able to use the 
shared library. 


For more information on how to use the shared library under CICS, see OS PL/I 
Optimizing Compiler: Programmer’s Guide. 


Using IBM Cataloged Procedures 


You can use IBM-supplied cataloged procedures that use the linkage editor or 
loader to specify the shared library. This procedure is described in OS PL/I 
Optimizing Compiler Programmer’s Guide. 


Using the XF Assembler to Create a Shared Library 


If you are using the XF Assembler to assemble these modules, it is possible that the 
total number of external symbol dictionary (ESD) items and/or entry points to be 
handled in an assembly will exceed the limits of the XF Assembler. 


If this occurs, the XF Assembler will produce an error diagnostic during execution 
of the job stream created by assembling the PLRSHR macro instruction. The 
PLRSHR macro will also produce a message giving an indication of the number of 
modules specified and how far the limit has been exceeded. This will cause 
subsequent assembly and link-edit steps to be flushed, and no shared library 
modules will be created. In this case, the number of options must be reduced in 
your PLRSHR macro instruction and the shared library generation process must be 
repeated. 


These problems will not arise when the H Assembler (Program Product Number 
5734-AS1) is used. 
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The following paragraphs describe how to calculate the number of entry points and 
ESD entries. 


The limits of the XF Assembler are: 

¢ The number of external symbol dictionary (ESD) items may not exceed 399. 

e The number of ENTRY symbols may not exceed 399. 

Figure 25 contains the total number of each of the above items for each PL/I 
library module subgroup in the shared library. The notes following the figure 
explain how to calculate the total number of items from Figure 25. Note that the 
actual numbers for complete functional groups of modules may be less than the 
totals of figures given for the subgroups contained within them. This applies to the 
input/output, mathematical, and conversion groups only. Consequently, it might 


be possible to create a shared library with totals calculated from the table in 
Figure 25 that slightly exceed the limits of the XF Assembler. 


ARRAY BASIC.LOGIC 


BASIC.LEAF 
CMATH 


BASIC .EVENT 
Figure 25 (Part 1 of 3). Table of Entry Points and ESD Entries in Shared Library Modules 
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CONTL TASK .WAIT 
TASK.CPLN 
TASK .PRTY 
NOTASK .WAIT 
NOTASK.CPLN 
NOTASK.PRTY 


ARITH.CHAR 
ARITH.DEC 
ARITH.BIN 
ARITH.BIT 
EDIT 
BIT.CHAR 
BIT.BIN 
CHAR .ARITH 
CHAR .BIT 
CHAR .PIC 
EXTND 
PIC.CHECK 
PIC.DEC 
PIC.BIT 
COMPLEX 


DATA. INPUT 
DATA. OUTPUT 
LIST. INPUT 
LIST. OUTPUT 
EDIT. INPUT 
EDIT. OUTPUT 
RECORD 

EXCL 

COPY 


RMATH FIXED.ADD 
FIXED.MULT 
FIXED.DIV 
SHORT. TRIG 
SHORT .ATRIG 
SHORT .HYPER 
SHORT .AHYPER 
SHORT .SQRT 
SHORT . EXPN 
SHORT .LOG 
SHORT .ERF 
LONG.TRIG 
LONG.ATRIG 
LONG.HYPER 
LONG .AHYPER 
LONG. SQRT 


Figure 25 (Part 2 of 3). Table of Entry Points and ESD Entries in Shared Library Modules 
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RMATH 
STORG 




















Figure 25 (Part 3 of 3). 








LONG .EXPN 
LONG.LOG 
LONG .ERF 
EXTND.TRIG 
EXTND.ATRIG 


EXTND.HYPER 
EXTND.AHYPER 
EXTND.SQRT 
EXTND.ERF 


ERR.ONCODE 
ERR.ONLOC 
ERR.CHECK 


PCON.CTL 
PCON.AREA 
STMAP 
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BIT.LOGIC 
BIT.COMPARE 
BIT.ASSIGN 
BIT. INDEX 
BIT.REPEAT 
BIT. VERIFY 
BIT.SUBSTR 
BIT.BOOL 
CHAR. INDEX 
CHAR. TRANS 
CHAR .REPEAT 
CHAR .VERIFY 
CHAR .SUBSTR 
STRING.BIF 
STRING.PV 
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Table of Entry Points and ESD Entries in Shared Library Modules 


Note that the calculations described below distinguish between the assemblies of 
modules that are to be assembled for inclusion in the link pack area and those to be 
included in SYS1.PLIBASE and SYS1.PLITASK. (The former constitute modules 
IBMBPSL (or IBMTPSL) and IBMBPSM, and will ultimately be loaded into the 
link pack area; the latter constitute modules IBMBPSR (or IBMTPSR) and will be 
link-edited into the PL/I load module. 


You can make the calculations as follows: 


1. Tocalculate the maximum number of entry points in IBMBPSR (or 
IBMTPSR), add the figures in column 1 for all subgroups, except the CONTL 
operand, specified in the PLRSHR macro; to this, add the appropriate tasking 
or nontasking subgroups of the CONTL operand. Add 4 to this figure to 
produce the final total, total A. 


2. Calculating the number of ESD entries generated in the assemblies 
(subsequently link-edited together) of module IBMBPSR (or IBMTPSR) 
requires a calculation for each of the two assemblies. 


To calculate the first total, add the figures in column 2 for the specified 
subgroups, except CONTL; to this, add the appropriate tasking or nontasking 
subgroups of the CONTL operand. Add 13 to this to obtain the final total, 


total B. 
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To calculate the second total, add the figures in column 4 for the specified 
subgroups; to this, add the greater of the sums of the tasking or nontasking 
subgroups of the CONTL operand that are specified. This gives the total C. 


3. To calculate the maximum number of entry points generated for IBMBPSM, 
add the figures in column 2 for the appropriate subgroups (excluding the 
subgroups of the CONTL operand). This gives the total D. 


4. Tocalculate the maximum number of ESD entries generated for IBMBPSM, 
add the figures in column 3 for the appropriate subgroups (excluding the 
subgroups of the CONTL operand). This gives the total E. 


The XF Assembler limits will not be exceeded if, for both tasking and nontasking 
PLRSHR macro instructions, the sum of the maximum of A and D, and the 
maximum of B, C, and E, is 399 or less. In this case, no further action is required 
before generating your shared library modules. 


If any of the above totals exceed the limits, you should reduce the number of 
PLRSHR operands specified until the totals are within this amount before 
proceeding with the shared library generation. 


Placing Transient Library Modules in the Link Pack Area 


All modules in the transient library, except for CICS-only transient library modules 
DFHSAP and IBMFnnnz, are eligible to be placed in the link pack area or MLPA. 
This has the advantage of saving execution time and space when more than one 
PL/I program is executing concurrently. 


You can make the modules resident at any time. 
Note: You should, however, be aware of the following facts: 


¢ SMP does not keep track of modules in the link pack area. Therefore, when 
you apply to the transient library a USERMOD or maintenance that affects a 
transient library module in the link pack area, you must recopy the updated 
module to the link pack area. 


¢ If you have programs compiled and link-edited on a previous release of PL/I, 
and if you had chosen when installing that release to improve initialization time 
by combining transient initialization/termination modules with resident 
initialization/termination modules, you must link-edit those programs again 
with the current resident library to avoid execution-time failures because of a 
mixture of release levels. 


The selection of modules that your site should make resident in the shared area 
depends upon the type of PL/I programs you normally run. 


For example, if your site has a high volume of short compile, link, and go jobs, you 
could make the transient housekeeping routines resident in the shared area to 
improve performance. 


Figure 26 on page 102 gives a guide to the conditions under which modules could 
advantageously be made resident. By selecting those conditions that apply to your 
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site, and then considering which of the modules within those sections you would 
use most frequently, you can build a list of modules to place in the link pack area. 
Details of how to actually place the modules in the resident area are given under 
“Using the Shared Library” on page 81. For IBMBPSLA, IBMTPSLA, and 
IBMBPSMaA, substitute the names of the transient library modules to be made 
resident. 


Note: The two housekeeping modules marked with an asterisk (*) in Figure 26 
are not needed for programs compiled and link-edited using Release 5.0 and later 
of OS PL/I. If you are running programs compiled and link-edited using previous 
releases of OS PL/I and you did not combine transient and resident 
initialization/termination modules, you might want to make these resident at this 
(Multitasking) 
Program Initialization 


time. 
Condition for 
Modules to be 
Resident Category Description 
Storage Management 
(Multitasking) 


Modules House keeping Storage Management 
generally needed 
(Multitasking) 
Program Initialization 






(Nonmultitasking) 
Storage Management 
(Nonmultitasking) 
Storage Management 
High volume of House keeping Program ISA Initialization 
short execution (Nonmultitasking) 
Program Termination 
(Nonmultitasking) 


(Multitasking) 
Program Termination 

(Multitasking) 
ATTACH macro 
instruction 

module 


High volume of OPEN/CLOSE Close 
OPEN/CLOSE Open - Phase 1 
statements or Open - Phase 2 
with at least one Open - Phase 3 
file being used Open - Phase 4 
(especially Open (VSAM) 
SYSPRINT) 


Figure 26 (Part 1 of 2). Transient Library Modules for the Link Pack Area 
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Condition for 
Modules to be 
Resident Category 


High volume of Stream I/O IBMBCCL Conversion Director 
Stream conversion (Complex strings) 
Input/Output IBMBCCR Conversion Director 
(Noncomplex string) 
IBMBSTA Tab Table 
IBMBSTF Print File Transmitter 
IBMBSTI Input File Transmitter 
IBMBSTV Print File Transmitter 
IBMCSTI Input File Transmitter 
(Checkout Compiler 
IBMCSTP Only) 
Output File Transmitter 
(Checkout Compiler 
Only) 


Record I/O Record I/O Buffered Consecutive 


consecutive 
(including 
in-line I/O) 


Record I/O 
Indexed 


Record I/O 
VSAM 





consecu- Transmitter 
tive Buffered Consecutive 
Transmitter 
Buffered Consecutive 
Transmitter 


Record I/O Indexed Sequential 

Indexed Transmitter 

Non-VSAM Indexed Sequential 

Transmitter 

Indexed Direct 
Transmitter 
Indexed Direct 
Transmitter 


Record I/O IBMBRVGA | KSDS Sequential Output 
VSAM IBMBRVAA | ESDS Transmitter 
IBMBRVHA | KSDS and Path 
IBMBRVIA | Input/Output 
RRDS Transmitter 


Figure 26 (Part 2 of 2). Transient Library Modules for the Link Pack Area 


Disabling the PL/I Fast Initialization/Termination Facility 


OS PL/I releases prior to release 5.0 provided separate initialization/termination 
modules that required system LOAD and DELETE functions to perform the 
initialization tasks. As a post-installation tuning option, you were allowed to 
combine these modules and thereby decrease the time it took to initialize or 
terminate the PL/I environment. 


Release 5.0 made this feature an integral part of the product. This improves 


performance but makes program load modules larger. If an application 
programmer is concerned with the size of these modules and is willing to sacrifice 
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performance, the following example may be used to remove the 
initialization/termination modules from the application program: 


//81 EXEC PLIXCLG, PARM.LKED='LET' 
//SYSIN DD * 
* 


* PL/I application program goes here 
* 


//LKED.SYSIN DD * 

REPLACE IBMBPII1,IBMBPIT1,IBMBPGR1 
INCLUDE SYSLIB(IBMBPIRA) 

NAME GO(R) 


In the above example, the initialization/termination modules will be removed from 
the load module. This will cause the LINKEDIT step to produce IEW0132 
messages. You can ignore these messages. 
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Index 


Special Characters 


*PROCESS statement 67 


ABEND 
generating 78 
macro argument 78 
flag byte 78 
ABEND codes 79 
abnormal termination 
See ABEND 
ACCEPT, SMP command 
issuing against compiler 45 
issuing against composite product 21 
issuing against resident library 37 
issuing against transient and resident libraries 37 
issuing against transient library 30 
AGGREGA option 67 
allocating data sets 
forcompiler 42 
for composite product 17 
for resident library 34 
forSMP 18, 27 
for transient library 26 
AMODE, PL/I option to identify 65 
APPLY, SMP command 
applying compiler option defaults changes 77 
applying execution-time option defaults changes 67 
issuing against composite product 20 
issuing against libraries and compiler 45 
issuing against transient and resident libraries 37 
issuing against transient library 30 
ARCH installation-time option 4, 64 
ARRAY option 86 
ATTRIBU option 67 
auxiliary storage requirements for installation 2 


batch mode, compiler options for 76 


cataloged procedures 9 
for compiler installation 17, 42 
for installation and maintenance 10 
for product invocation 9, 10 
modifying 9 
specifying options for 10 
specifying region size 10 
invocation, target library for 17, 42 
to specify shared library 97 
cataloging data sets 
for compiler 42 
for composite product 17 
for resident library 34 
for transient library 26 
changing compiler options 
for batch mode processing 76 
forTSO 76 
CHAR option 94 
CHARSET option 67 
Checkpoint/Restart interface, system requirements for 3 
choosing 
optional components 6, 8 
program products 6 
target libraries 8 
choosing optional components 6 
choosing target libraries 
forcompiler 16, 42 
for composite product 16 
for resident library 16,33 
for transient library 16, 26 
CICS 
shared library usage under 97 
CICS component library 
target for resident library 17,34 
CICS support 2, 11 
allocating transient library modules 27 
choosing target libraries for 26 
CLPA, MVS option 96 
CMATH option 87 
coding changes 
to compiler option defaults 75 
to execution-time option defaults 65 
to PLIXOPB macro 75 
to PLIXOPC macro 75 
to PLTRLIB macro 65 
coding conventions 
for changing compiler option defaults 72 
for changing execution-time option defaults 58 
for PLIXOPB and PLIXOPC macros 72 
for PLTRLIB macro 58 
common storage, loading shared library into 96 
compatibility 
across releases using shared library 82 
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between different release levels of compiler and 
libraries 1 
of releases running under CICS 2 
shared libraries with different options 83 
COMPILE option 67 
compiler 
allocating and cataloging data sets for 42 
executing SMP ACCEPT 45 
executing SMP APPLY 45 
executing SMP RECEIVE 44 
installing 39-46 
JCL for installing 40 
obtaining from distribution tape 40 
printing 41 
running jobs toinstall 44 
compiler options 
See also options, compiler 
changing IBM-supplied defaults 67 
CONTROL 75 
DELETE 75 
executing SMP APPLY 77 
executing SMP RECEIVE 77 
FMARGIN macro operand 73 
for batch mode processing, changing defaults 76 
for TSO, changing defaults 76 
FSEQUEN macro operand 73 
GRAPHIC 73-74 
MARGIN 73,74 
with fixed-length records 73 
with variable-length records 74 
PRINT 72-73 
SEQUENCE 73,74 
with F-format source input 73 
with V-format source input 74 
TSTAMP 74 
used only at time of installation 72-75 
VMARGIN macro operand 74 
VSEQUEN macro operand 74 
COMPILETIME preprocessor function 74 
compiling the sample program 47 
composite product 
allocating and cataloging data sets for 17 
choosing target libraries for 16 
executing SMP ACCEPT 21 
executing SMP APPLY 20 
executing SMP RECEIVE 20 
installation 7 
installing 13-21 
JCL for installing 14 
printing 16 
jobs for installing 
obtaining from distribution tape 14 
messages received while installing 20 
running jobs to install 19 
CONTL option 88 
CONTROL option 67,75 
CONV option 88 
copying installation JCL 
for installing compiler 41 
copying JCL 
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for installing composite product 15 

for installing resident library 33 

for installing transient library 25 
copying the sample program 47 
COUNT option 67 
customizing your OS PL/I product 81-104 
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data sets 
allocating and cataloging 
forcompiler 42 
for composite product 17 
for resident library 34 
for transient library 26 
allocating and initializing 
SMP 18, 27 
DECK option 67 
default values 
for compiler options 68 
for execution-time options 56 
defaults, IBM-supplied 
changing 55-78 
for compiler options 11 
changing 11, 67 
for execution-time options 11 
changing 11, 56-67 
DELETE option 67 
explanation of 75 
descriptions 
of execution-time options 59-65 
of PLTRLIB macro operands 59-65 
disabling fast initialization/termination 103 
distribution 
of program product 3 
tape contents 
compiler 39 
composite product 13 
resident library 31 
transient library 23 
tape formats 4 
tape names and numbers 3 
compiler 39 
composite product 13 
resident library 31 
transient library 23 
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entry points in shared library 98 
ERROR 

on-unit 78 

user exit, modifying 78 
ESD entries in shared library 98 
ESD option 67 
executing the sample program 47 


execution-time options 4-5 
See also options, execution-time 
changing IBM-supplied defaults 56-67 
for nontasking environment 
HEAP 59 
ISAINC 60 
ISASIZE 60 
NOREPORT 61 
NOSPIE 61 
NOSTAE 6l 
REPORT 60 
SPIE 61 
STAE 61 
for tasking environment 
HEAP 61 
ISAINC 62 
ISASIZE 62 
NOREPORT 63 
NOSPIE 63 
NOSTAE 64 
REPORT 63 
SPIE 63 
STAE 63 
TASKHEAP 64 
HEAP 4 
ISAINC 4 
NONTASK option 59 
description 59 
suboption descriptions 59 
TASK option 61, 64 
description 61 
suboption descriptions 61-64 
TASKHEAP 5 
extended architecture, option to specify 64 
extended floating point support 3 
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fast initialization/termination, disabling 103 
FLAG option 67 

flags, ABEND code 78 

floating point calculation support 3 

FLOW option 67 

FMARGIN macro operand 73 

FMARGINI option 67 

format of distribution tapes 4 

FSEQUEN macro operand 73 

FSEQUEN option 67 


general information 
about product installation 1, 11 
GONUMBE option 67 
GOSTMT option 67 
GRAPHIC option 67, 73-74, 89 
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HEAP option 4 
in a nontasking environment 59 
in a tasking environment 61 


o 


IBM-supplied defaults 
for compiler options 68 
for execution-time options 56 
IBMBEER 78 
including in resident library 79 
IBMBPSLA shared library module 96 
IBMBPSMaA shared library module 96 
IBMBPSRA shared library module 96 
IBMBXOPT transient library module 
modifying with SMP USERMOD 58 
replacing lines in 65 
IBMTPSLA shared library module 96 
IBMTPSRA shared library module 96 
IEBCOPY utility 
using when installing compiler 41 
using when installing composite product 15 
using when installing resident library 33 
using when installing transient library 25 
IEBPTPCH utility 
using when installing compiler 41, 47 
using when installing composite product 16 
using when installing resident library 33 
using when installing transient library 25 
IEBUPDTE utility 
to change compiler option defaults 69-77 
to change execution-time option defaults 57 
using to change compiler option defaults 76 
using to change execution-time option defaults 66 
IEHMOVE utility 17, 26,34, 42 
IELOAS compiler source module 
modifying with SMP USERMOD 69-77 
replacing linesin 75 
IELOAT compiler source module 
modifying with SMP USERMOD 69-77 
replacing lines in 75 
IEL04131 E, diagnostic message 48 
IEW0342, linkage editor message 
while installing compiler 45 
while installing composite product 20 
while installing resident library 37 
while installing transient library 30 
IEW0461, linkage editor message 
while installing compiler 45 
while installing composite product 20 
while installing resident library 37 
IMPRECI option 67 
IMS/VS_ 11 
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INCLUDE option 67 
initializing data sets for SMP 
INSOURC option 67 
installation 
choosing optional components 8 
choosing target libraries for 8 
general information 1 
in a multiprogramming environment 7 
machine requirements for 2 
of composite product 7 
operating system requirements for 2 
preparing for 8 
process overview 5 
sequence 6 
storage requirements for 2 
installation cataloged procedures 
installation-time option, ARCH 
installing compiler 39-46 
cataloged procedure for 43 
JCL for 
allocating datasets 43 
obtaining from distribution tape 40 
printing 41 
messages received 45 
running job to apply product 45 
running job to receive product 44 
installing composite product 13-21 
cataloged procedure for 19 
JCL for 
allocating data sets 17 
allocating SMP datasets 18 
printing 16 
jobs for 
obtaining from distribution tape 14 
messages received 20 
running job to apply product 20 
running job to receive product 19 
installing resident library 31-37 
cataloged procedure for 35 
JCL for 
allocating datasets 35 
obtaining from distribution tape 32 
printing 33 
messages received 37 
running job to apply product 37 
running job to receive product 36 
installing transient library 23-30 
cataloged procedure for 28 
JCL for 
allocating data sets 27 
allocating SMP datasets 27 
obtaining from distribution tape 24 
printing 25 
messages received 30 
running job to apply product 29 
running job to receive product 28 
interrelease compatibility 1 
INTERRU option 67 
invocation cataloged procedure 
target library for 17, 42 
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invocation cataloged procedures 
modifying 9 
specifying options for 10 
specifying region size 10 

IO option 90 

ISAINC option 4 
in a nontasking environment 60 
in a tasking environment 62 

ISASIZE option 
in a nontasking environment 60 
in a tasking environment 62 


JCL 
for adding cataloged procedure 
for compiler installation 43 
for composite product installation 19 
for resident library installation 35 
for transient library installation 28 
for allocating and cataloging 
compiler 43 
composite product 17 
resident library 35 
transient library 27 
for allocating and initializing 
SMP data sets 18, 27 
for installing compiler 
job names 40 
obtaining from distribution tape 40 
printing 41 
for installing composite product 
job names 14 
obtaining from distribution tape 14 
printing 16 
for installing resident library 
job names 32 
obtaining from distribution tape 32 
printing 33 
for installing transient library 
job names 24 
obtaining from distribution tape 24 
printing 25 
job 1, shared library 84 
job 2, shared library 95 
JOBSTMT option 91 


libraries 
choosing 8 
target, private vs. system 8 
libraries, target 
for compiler, choosing 17, 42 
for command load modules 16 
for invocation cataloged procedure 16, 42 


for sample program 16, 42 
for source modules 16, 42 
for TSO command load modules 42 
for TSO HELP modules _ 16, 42 
for composite product, choosing 16 
for resident library, choosing 16, 33, 34 
for CICS component 16, 34 
for multitasking component 33 
for required material 33 
for shared library component 33 
for transient library, choosing 16, 26 
link 16, 26 
procedure 16, 26 
using existing libraries 17, 26, 34, 42 
library 
shared 81-97 
library, resident 
See resident library 
library, shared 11 
See also shared library 
library, transient 
See transient library 
LINECOU option 67 
link library 
target for CICS modules 26 
target for transient library 26 
link library, target for transient library 16 
link pack area 
applying maintenance to modulesin 11 
building shared library in 81 
placing transient library modulesin 101-103 
shared library modules in 83 
link pack area, modified 96 
link-editing the sample program 47 
linkage editor messages received while installing 
compiler 45 
composite product 20 
resident library 37 
shared library 96 
transient library 30 
linklist 96 
LIST option 67 
LMESSAG option 67 
L4ALLOC 32,35 
L4APPLY 32 
modifying to ACCEPT libraries 37 
to APPLY transient and resident libraries 37 
L4PROC 32,35 
L4RECEIV 32, 36 
L4RUN 37 
LSALLOC 24,27 
LSALSMPE 24, 27 
LSALSMP4 24, 27 
LSAPPLY 24 
modifying to ACCEPT transient library 30 
to APPLY transient library 29 
LSMOD 24 
adapting to your needs 66 
changing execution-time option defaults 67 
sample USERMOD 65 
LSPROC 24, 28 


LSRECEIV 24, 29 
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machine requirements for installation 2 
MACRO option 67 
MAP option 67 
MARGIN option 73 
with fixed-length records 73 
with variable-length records 74 
MARGINI option 67 
MDECK option 67 
messages received while installing 
compiler 45 
composite product 20 
resident library 37 
shared library 96 
transient library 30 
MFUNC option 91 
MLPA facility 96 
MODES option 85 
modified link pack area 96 
modifying 
compiler option defaults 69-77 
IBM-supplied defaults 11, 55-78 
for compiler options 11, 67 
for execution-time options 11, 56-67 
IBMBEER 78 
IELOAS compiler source module 69-77 
IELOAT compiler source module 69-77 
JCL 
for allocating compiler data sets 43 
for allocating composite product data sets 17 
for allocating resident library datasets 35 
for allocating SMP data sets 27 
for allocating transient library data sets 27 
for compiler cataloged procedure 43 
for composite product cataloged procedure 19 
for installing compiler 44, 45 
for installing composite product 20 
for installing resident library 36 
for installing transient library 29 
for transient library cataloged procedure 28 
to ACCEPT compiler 45 
to ACCEPT resident library 37 
to ACCEPT the composite product 21 
to ACCEPT transient library 30 
PLIXOPB macro instruction 69-77 
PLIXOPC macro instruction 69-77 
user error exit routine 78 
multiprogramming environment, installing in 7 
multitasking component library 
target for resident library 33 
multitasking environment, execution-time options for 56 
MVS link pack area 
building shared library in 81-97 
MVS linklist 96 
MVS/XA, option to specify 64 
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NEST option 67 
new programming features 

execution-time options 4-5 

extended architecture (XA) 4 

installation-time option 4 
NONTASK option 

description 59 

format 59 

suboptions 59-61 

description 61 
suboption descriptions 61 

nontasking environment, execution-time options for 56 
NOREPORT option 

in a nontasking environment 61 

in a tasking environment 63 
NOSPIE option 

in a nontasking environment 61 

in a tasking environment 63 
NOSTAE option 

in a nontasking environment 61 

in a tasking environment 64 
NUMBER option 67 
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OBJECT option 67 
OFFSET option 67 
operands 72 
of PLRSHR macro 85 
operating system 
compiler operation under _ iii 
operating system requirements 3 
for use of PL/I Checkpoint/Restart interface 3 
OPTIMIZ option 67 
optimizing compiler 
messages received while installing 45 
optional components 
choosing 6,8 
options 
changing IBM-supplied defaults 55-78 
OPTIONS option 67 
options, compiler 
See also compiler options 
changing IBM-supplied defaults 11 
IBM-supplied defaults 68 
options, execution-time 
See also execution-time options 
changing IBM-supplied defaults 11, 56-67 
options, installation-time 
ARCH 64 
options, shared library 
ARRAY 86 
CHAR 94 
CMATH 87 
CONTL 88 
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CONV 88 
GRAPHIC 89 
IO 90 
JOBSTMT 91 
MFUNC 91 
MODES 85 
RMATH 92 
STORG 93 
STRGS 94 
STRING 95 
OS PL/I Optimizing Compiler 
See compiler 
OS PL/I Optimizing Compiler and Libraries 
See composite product | 
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performance, improving 11 
PLI.CMDLIB 9,17, 42 
PLI.HELP 17,42 
PLILINSTALL 
obtaining installation jobs from 14 
obtaining JCL from 
for installing compiler 40 
for installing resident library 32 
for installing transient library 24 
printing JCL in 
for compiler installation 41 
for composite product installation 16 
for resident library installation 33 
for transient library installation 25 
PLILLOGPROC 42 
PLI.PLIBASE 9, 17, 34 
including IBMBEER module in 79 
target for resident library 33 
PLILPLICOMP 17, 42 
PLI.LPLIHELP 9 
PLI.PLILINK 9 
target for CICS modules 26 
target for transient library 26 
PLI.PLILINK, target for transient library 16, 28 
PLI.PLITASK 9 
target for resident library 19,33, 35, 44 
PLI.PROCLIB 9 
target for compiler 17, 42, 43 
target for composite product 19 
target for resident library 35 
target for transient library 16, 26, 28 
PLI.SAMPLIB 17, 42, 47 
target for CICS modules 26 
PLISHRMAC 33,85 
PLIXOPB macro instruction 75 
coding changesto 75 
coding conventions 72 
example 71 
modifying 69-77 
PLIXOPC macro instruction 75 
coding changes to 75 


coding conventions 72 
contents 
change after installation 75 
default options 75 
modifying 69-77 
PLRSHR macro 84 
assembling 95 
coding 
conventions 85 
example 85 
operand descriptions 85 
PLTRLIB macro 
See also execution-time options 
coding changes to 65 
coding conventions 58 
modifying 58 
operand descriptions 59-65 
post installation tuning 11, 81-104 
shared library 11 
applying maintenance to 11 
shared library facility 11 
applying maintenance to 11 
PRINT option 67, 72-73 
printing JCL 
for installing compiler 41 
for installing composite product 16 
for installing resident library 33 
for installing transient library 25 
private libraries vs. system libraries 8 
procedure library 
target for resident library 33 
target for transient library 16, 26 
procedures, cataloged 9 
for installing compiler 43 
for installing composite product 19 
for installing resident library 35 
for installing transient library 28 
program product distribution 3 
program products 
choosing 6 
program termination routine 78 
program, sample 
compiling 47 
copying 47 
running 47 
publications, reference iv 
PIALLOC 40, 43 
PIAPPLY 
description 40 
modifying to ACCEPT compiler and libraries 45 
to APPLY compiler and libraries 45 
PIMOD 40 
adapting to your needs 76 
P1IMOD sample USERMOD 75 
PIPROC 40, 43 
PIRECEIV 40, 44 
P3ALLOC 14,17 
P3ALSMPE 18 
P3ALSMP4 18 
P3APPLY 
description 14 


modifying to ACCEPT composite product 21 
to APPLY composite product 20 

P3MOD_ 14 

P3PROC 14,19 

P3RECEIV 14, 20 


[R| 


RECEIVE, SMP command 
issuing against compiler 44 
issuing against composite product 20 
issuing against resident library 37 
issuing against transient library 29 
receiving compiler option defaults changes 77 
receiving execution-time option defaults changes 67 
reference publications iv 
release level 
of SMP required _ iii 
release levels 
compiler and library release level compatibilities 1 
REPORT option 
in a nontasking environment 60 
in a tasking environment 63 
requirements 
storage, reducing 11 
requirements for installation 
machine 2 
operating system 2 
storage 2 
forOS PL/I 2 
forSMP 2 
resident library 
allocating and cataloging data setsfor 34 
executing SMP ACCEPT 37 
executing SMP APPLY 37 
executing SMP RECEIVE 37 
installing 31-37 
JCL for installing 32 
obtaining from distribution tape 32 
printing 33 
messages received while installing 37 
placing in shared library 81-97 
running jobs to install 36 
RMATH option 92 
RMODE, PL/I option to identify 65 
routine, program termination 78 
running the sample program 47 


[s| 


sample program 

compiling 47 

copying 47 

running 47 

target library for 17, 42 
sequence numbers, matching 65, 75 


Index 111 


SEQUENCE option 73, 74 
with F-format source input 73 
with V-format source input 74 
shared library 81, 97 
advantages of 82 
and SMP 82 
applying maintenance to 11 
assembling options macro 95 
benefits of 82 
built with XF Assembler 97-101 
cataloged procedures to specify 97 
coding macro 
coding conventions 85 
example 85 
operand descriptions 85 
compatibility across releases 82 
compatibility with different options 83 
costs of 82 
creating 83-96 
disadvantages of 82 
entry points in 98 
ESD entriesin 98 
IBMBPSLA module 96 
IBMBPSMA module 96 
IBMBPSRA module 96 
IBMTPSLA module 96 
IBMTPSRA module 96 
inSYS1.LPALIB 96 
loading for use under CICS 97 
loading into common storage 96 
modules in link pack area 83 
running job 1 84 
running job2 95 
target for resident library 33 
testing 96 
shared library facility 
applying maintenance to 11 
building 11 
shared library options 
See options, shared library 
SIZE option 67 
SMP 
ACCEPT 
and RESTORE, used for compiler and 
libraries 45 
and RESTORE, used for composite product 21 
and RESTORE, used for transient and resident 
libraries 37 
and RESTORE, used for transient library 30 
executing against compiler and libraries 45 
executing against composite product 21 
executing against transient and resident 
libraries 37 
executing against transient library 30 
allocating and initializing data sets for 18, 27 
and shared library 82 
APPLY 
applying compiler option defaults changes 77 
executing against composite product 20 
executing against libraries and compiler 45 


112 OS PL/I Installation Guide for MVS 


executing against transient and resident 
libraries 37 
executing against transient library 30 
procedures on distribution tape 
forcompiler 39 
for composite product 13 
for resident library 32 
for transient library 23 
RECEIVE 
executing against compiler 44 
executing against composite product 20 
executing against resident library 37 
executing against transient library 29 
receiving compiler option defaults changes 77 
release level required iii 
sample USERMOD 
for changing compiler option defaults 76 
for changing execution-time options 66 
storage requirements 2 
USERMOD 
changing execution-time option defaults 67 
to change compiler option defaults 69-77 
to change execution-time option defaults 57 
USERMOD, writing 11 
writing USERMOD 
to change compiler option defaults 75 
to change execution-time option defaults 65 
SMP/E 
See SMP 
SOURCE option 67 
SPIE option 
in a nontasking environment 61 
in a tasking environment 63 
STAE option 
in a nontasking environment 61 
in a tasking environment 63 
STATIC INTERNAL CSECT 74 
STMT option 67 
STORAGE option 67 
storage requirements 
reducing 11 
STORG option 93 
STRGS option 94 
STRING option 95 
SYNTAX option 67 
System Modification Program 
See SMP 
System Modification Program Extended 
See SMP 
system requirements 2 
SYS1.CMDLIB 9,17, 42 
SYS1.HELP 9, 17, 42 
SYS1.LINKLIB 
target for CICS modules 26 
target for compiler 17, 42 
target for transient library 16, 26, 28 
SYS1.LPALIB 
shared library in 96 
SYS1.PARMLIB 96 
SYS1.PLIBASE 9, 17,34 


target for resident library 33 

target for shared library 83 
SYS1.PLITASK 

target for resident library 19, 33, 35, 44 

target for shared library 83 
SYS1.PROCLIB 

target for compiler 17, 42, 43 

target for composite product 19 

target for resident library 35 

target for transient library 16, 26, 28 
SYS1.SAMPLIB _ 17, 42, 47 

target for CICS modules 26 
SYS1.SHRMAC 33 


tape, distribution 
format of 4 
names and numbers 3 
compiler 39 
composite product 13 
resident library 31 
transient library 23 
target libraries, choosing 
for compiler 16, 42 
for composite product 16 
for resident library 16, 33 
for transient library 16, 26 
private vs. system 8 
using existing libraries 17, 26, 34, 42 
TASK option 
description 61 
format 61 
suboptions 61-64 
TASKHEAP option 5 
in a tasking environment 64 
tasking environment 
execution-time options for 56 
TERMINA option 67 
termination routine, program 78 
transient library 
allocating and cataloging data sets for 26 
applying maintenance to 11 
executing SMP ACCEPT 30, 37 


executing SMP APPLY 30 
executing SMP RECEIVE 29 
installing 23-30 
JCL for installing 24 
obtaining from distribution tape 24 
printing 25 
messages received while installing 30 
modules in the link pack area 101-103 
placing modules in link pack area_ 11 
running jobs to install 28 
TSO, compiler options for 76 
TSTAMP option 67, 74 
tuning, post installation 11, 81-104 


user error exit routine 78 
USERMOD 
sample, LSMOD 65 
sample,P1MOD 75 


VMARGIN macro operand 74 
VMARGINI option 67 
VSEQUEN macro operand 74 
VSEQUEN option 67 


[x] 


XF Assembler with shared library 97-101 
XREF option 67 


3001 ABEND code 79 
3002 ABEND code 79 


Index 113 


Staples can cause problems with automated mail sorting equipment. 
Please use pressure sensitive or other gummed tape to sea! this form. 


Note: 


e@aeseepenepeoeue Oe 


ee¢@esvpneesovuweeonueae 


eee 


ereoeseeeoeoe eee eoneaevneeeneeanseeesenoneeeneeeseeaeeeeseeanseeeenaeoeeee 


eee etaeeaea nana 


eeeeoeoeonre 


@esaeoneescopeoesv eB Beoe od 


2 


Reader’s 


OS PL/I Optimizing Compiler: reialaliaal 
Installation Guide for MVS orm 
$C26-4121-1 


This manual is part of a library that serves as a reference source for systems analysts, programmers, and operators of 
IBM systems. You may use this form to communicate your comments about this publication, its organization, or 
subject matter, with the understanding that IBM may use or distribute whatever information you supply in any way 
it believes appropriate without incurring any obligation to you. 

Your comments will be sent to the author’s department for whatever review and action, if any, are deemed 
appropriate. 
Note: Copies of IBM publications are not stocked at the location to which this form is addressed. Please direct any 
requests for copies of publications, or for assistance in using your IBM system, to your IBM representative or to 
the IBM branch office serving your locality. 


List TNLs here: 

If you have applied any technical newsletters (TNLs) to this book, please list them here: 
Last TNL 
Previous TNL 


Previous TNL 


Fold on two lines, tape, and mail. No postage stamp necessary if mailed in the U.S.A. 
(Elsewhere, an IBM office or representative will be happy to forward your comments or you 
may mail directly to the address in the Edition Notice on the back of the title page.) Thank 
you for your cooperation. 


$C26-4121-1 


Reader’s Comment Form 


Fold and tape Please do not staple 





IN THE 
UNITED STATES 
ae 
BUSINESS REPLY MAIL Ss 
FIRSTCLASS PERMITNO.40 ARMONK,N.Y. ee 
POSTAGE WILL BE PAID BY ADDRESSEE SSS 
eS 
ST 
a ee ee] 
IBM Corporation RE! 
P.O. Box 50020 aa SA 
Programming Publishing ates ies Gan, St wae en al 
San Jose, California $5150 eee 
ie ara 
TS 
Frac ee ee ea) 


Fold and tape Piease do not staple 


satf 
oll! 





Fold and tape 


NO POSTAGE 
NECESSARY 


iF MAILED 


Fold and tape 


@@®@e@#eeseseosesoeae Oe se eeeve sds 


eeseqgquGceaesePePee eee ena neeeeoeoen ee be 


e2¢eeos 


eee GeeeveesoeoewetevpeesedBeeaenwaweeeseneanevneeneuneve 


@ese@nenenests 


:4a}{dwod Buiziwido i/1d SO 


L-LZLv-9ZOS ‘“VW'S'N U! PAUld (PE-OLES “ON Al!4) SAW 40} pind uolne|/eysu} 


en 








OS PL/I Optimizing Compiler: Installation Guide for MVS (File No. S370-34) Printed in U.S.A. SC26-4121-1 





$C26-4121-1 











